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CYCLE 5 HELPFUL HINTS 


This paper describes helpful hints on how to use Cycle 5 of 
NOS/VE. It is intended to supplements, rather than to replaces 
the standard NOS/VE documentation. If you have any questions or 
suggestions» please see Tom McGee or Bonnie Swierzbins Appendix 
D lists background documents and how to obtain them. 


To obtain additional copies of this document white running on 
SN101 at Arden Hills, please type: 


SESaINTI.LISTHINTS C#=<number of coples> 


To obtain a copy with revision bars against the Helpful Hints 
of the previous builds one can type? 


SES»sINTL.~LISTHINTS REVB C=<number of copies> 


The € parameter Is optional and defaults to one. 


Usdate History 

Date Changes 

12/22/80 Revisions for NOS/VE Phase C 

2/12/81 Additional Revisions for NOS/VE Phase C 
6/09/81 Revisions for NOS/VE Build N 

6/19/81 Additional Revisions for NOS/VE Build N 
8/28/81 Revisions for NOS/VE Build 0 

11/06/81 Revisions for NOS/VE Build ® 

3/01/82 Revisions for NOS/VE Bulld Q 

4/15/82 Revisions for NOS/VE Cycle 2 

5/01/82 Revisions for NOS/VE Cycle 3 

6/30/82 Revisions for NOS/VE Cycle 5 
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1.40 MAJOR CHARACTERISTICS GF THIS BUILD 


160 MAJOR _ CHARACTERISTICS _OF_ THIS. BUILD 


o The TAFNVE operator command (TAF control point) is no tonger 
required or available. The capabilities that were provided by 
it have been packaged within the NVE subsystem contro! point. 
The impact of this change is as follows: 


~ The K display is assigned to the same control point 
during both deadstart and normal system operation. 


- Qutput from the system core debugger willl no tonger 
appear at the NVE control! point K-display. All system 
core debugger communication Is via the MDD terminal. 


- The K»~*BYEVE. command is no ftonger available. 


- The 2.0FFSW6. command before doing a 2eSTOP. is not 
required to bring NVE down. 


—- All capabilities are available via the NeNVExxxx 
command. The NVE subsystem may be placed at any contro! 
point (like NAM is). 


o Cycle 5 (actually Cycle 4) of NOS/VE no tonger supports the 
"oid" command names for system commands. Both ™"old™ and "newn” 
names have been supported since Bulld 9. See DAP ARH4776 for 
details. As pert of this change the abbreviations for the 
COPY_FILE and PRINT_FILE commands have been corrected to COPF 
and PRIF (from COPYF and PRINTF). 


o The EXPLAIN command was implemented in Cycte 4 of NOS/VE. 
Don't get too excited about thiss howevers because as yet 
there are no "explain level™ message templates for any of the 
system conditions. EXPLAIN will simpty regurgitate the 
regular messag@e 


While implementing the EXPLAIN command it was discovered that 
the specification of the command (1.e- that it have an 
optional “condition™ parameter) was not nearly as useful as 
having the first parameter be a “status"™ value, So the 
implementation deviates from the ERS In that the first 
parameter to EXPLAIN is MESSAGE_STATUS or MS and is of kind 
STATUS. The S$STATUS function can be used to transform a 
"condition™ into a "status™. A DAP is being written to make 
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1.0 MAJOR CHARACTERISTICS GF THIS BUILD 


this change official. 


o 6 The implicit attach process has been modified to choose share 
mode to be the following function of access mode If access 
mode includes shortens append or modify then share mode Is 
nones otherwise share mode is read and execute. This results 
in allowing sharing of implicitiy attached files that are not 
being written but inhibiting sharing of implicitiy attached 
files that are being written. 


The implicit attach process formerty chose share mode to be 
the share requirements established by the permit mechanism. 
The owner of files typically has no share requirements and 
hence would implicitiy attach the files for exclusive access. 
This created a severe usability problem for code or command 
files that were to be executed by multiple jobs. 


It seems that many people are running into a problem on the 
System concerning the use of "path" references to files. 
Specificaliys, a job will "hang" if a CREATE_FILE (define) or 
ATTACH _FILE (attach) command for a file is followed by by 
another reference to the file using the “path” notation. For 
example: 


CREATE_FILE SUSER.~JUNK 


® 


COPY_FILE SUSER.JUNK NEWJUNK 


will) result =n the job begin hung. The reason Is that there 
is a LOCAL_LFILELNAME parameter on the create_file command 
which defaults to the name of the permanent file (in the 
exampite:s JUNK); but the "implicit" access to the file via the 
copy_file command uses an internally generated focal name for 
the file. Thusy the effect is the same as the following 
command sequence on NOS: \ 


DEFINEs JUNK. 


ATTACHs zuni que=JUNK. 
COPYszunique sNEWJUNK. 


Heres the job wilt hang on the attach command because of 
conflicting access to file JUNK. 


On NOS/VEs explicit use of the CREATE FILE and <ATTACH_FILE 
commands is not generatiy necessary. For example: 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


COPY_FILE »MY_LFRIEND.»SOME_FILE SUSER.~SOME_FILE 


wild Cimplicitty) attach file SOME_LFILE from user MY_LFRIEND's 
master catalogs create file SOME_LFILE in my master catalog and 
copy the former Into the latter (if SOMELFILE already existed 
in my master catatogs it would be attached and overwritten). 


DD NOT MIX “IMPLICIT” ATTACH/CREATE WITH "EXPLICIT" 
ATTACH/CREATE. 


If you insist on explicitly attaching or creating files then 
USE THE LOCAL FILE NAME that you assianed via the ATTACH FILE 
or CREATE_FILE command. 


Sheldon Fewer is writing a DAP proposing to change the default 
for the LOCAL FILE NAME parameter on the CREATE_FILE and 
ATTACH_ FILE commands.» If sanity prevailss this DAP will be 
approved and the problem outiined above will be targety 
resolved. Until then PLEASE USE EITHER EXPLICIT ACCESS OR 
IMPLICIT ACCESS (preferably the tatter) BUT NOT BOTH!!! 


o With the advent of NOS/VE Cycle 1424324 SCU command = and 
parameter names were updated per DAP 4968. OGniy the new names 
are recognized nowe Documentation for the current version of 
SCU can be Found In the ERSs DCS number ARH3883 revision F. 
Command summaries can be obtained from Mike Perreten in Arden 
Hilts or Stacy Buckley in Sunnyvale. The material accessed by 
the non-standard command display command information has been 
uodated for 5CU,. The use of display _command_list with 
display_options equal to full while inside SCU may prove 
useful. 


o An EDI problem exists with respect to a file shared between 
Jobs. An existing file is opened with an access mode of 
append by job Ae The same file is opened with an access mode 
of read by job 8B. Job A extends the file and either 
explicitly closes the file or terminates. Job B explicitly 
closes the file or terminatese In this cases since the job 
accessing the file in read mode terminated after the job which 
extended the files ENI on the file will be reset to the 
criginal position and the result of the extend will be fost. 


o The Interstate Communication Facilitys which is described In 
Section 9 of the NOS/VE ERS - Program Interface (Rev. 38)» has 
been implemented. The callable subroutines described in 
section 9.3 reside in User Library LINKLIB In the Integration 
catalogs INTl»s DEVis REL1l» etc. NOS tibraries SYSLIA and 
SRVLIB are atso required to complete the ltoading processes 
LDOSET foader commands must be used to select these tlibraries. 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


o Interactive Usage Restrictions: 


- When ftogging in to NOS/VE (ize. HELLOsTAF etc.) do not 
enter a terminate break (CTRL t) or a pause break (CTRL p) 
before the ‘welcome message’ appears at the terminal. A 
pause or terminate break entered before the interactive 
NOS/VE job has completed it*s initialization may crash the 
system. 


- A REQUESTLTERMINAL command in a batch job will crash the 
system. This can happen accidentiy through a 
REQUEST_TERMINAL command in a euser prolog when the user 
runs a batch job since the prolog is executed for both 
interactive and batch jobs. The problem can be avoided by 
making the REQUEST TERMINAL command in the prolog 
conditional on the job type as follows: 


IF $JOB(MQDE) <> *BATCH* THEN 
REQUEST_TERMINAL 
IFEND 


o Any product or utility that is placed in the SSYSTEM catalog 
(or any frequentiy loaded program) should be bound using the 
CREATE MODULE subcommand of the CREATE_OBJECT_LIBRARY 
utility. This will minimize overhead associated with toading 
the product or utility. 


o Debug responds to terminal breaks when a program is being 
debugged. Howevers entering a pause or terminate break when 
debug is active (i.e. the DB/ prompt has appeared and the 
user has not issued the RUN command) will cause the task to 
terminate. 


o When sharing executable files via permanent files (i.e. 
compilerss librariess etc.) you should make the file an 
object library via the CREATE_LOBJECTLLIBRARY utility. By 
sharing object libraries instead of object files» the code is 
actually shared among all tasks using the !tibrary; the library 
is not copied to another segment but is executed directly. 


1.1 NOS/VE_USAGE EXAMPLES 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
Le1l.1 EXECUTING PROGRAMS 


1le1l.1 EXECUTING PROGRAMS 


PROCESS | 


Create an object text file by compiling a program on NOS. 


Then perform the following steps on NOS/VE3: 


Acquire any necessary libraries (which are not quoted in text 
embedded directives) by either? 


o Attaching them from the system catalogs either explicitly 
or via prolog 
| or 
© Creating the ttibrary file via the object library generator 
or 
0 Staging the lfbrary file from NOS to NOS/VE using the 
GET_OBJECT_LIBRARY command. 


Get the file from NOS and convert the object text file from 
the CI data mapping to II data mapping by executing the 
CONVERT_LOBJECT_LFILE command. 


Load and execute the program via the EXECUTE_TASK commands 
specifying the necessary Jibraries with the LIBRARY parameter; 
alternatively SETLUPROGRAM_ATTRIBUTES may be used to inctude 
the libraries in ali subsequent EXECUTE_TASK commands. 


Stage the loadmap from NOS/VE to NQS for printing by using 
either: 


o The REPLACE_FILE command with A6 conversion mode specified 
if running on the simulator. 
or 
o The PRINT LFILE command if running on the hardware. 
EXAMPLES 


The following is an example command sequence for executing a 


program not reauiring any tibraries for loading: 


Assumptions: all modules to be loaded are contained on the NOS 


permanent File 'citxtrs'!. 


CONVERTLOBJECTLFILE CITXTRS 
EXECUTE_TASK CITXTRS PARAMETER="* program parameters? 
PRINT LFILE LOADMAP 
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The fotlowing is an example command sequence for executing a 
program requiring libraries for loading? 


Assumptions: the NOS permanent file tcitxtrs? contains object 
text generated by the CYBIL CI compiler. The compiler modules 
reference procedures contained on the tibrary ‘mylib*’ and the 
CYBIL run-time library. These tibraries have been generated on 
NOS/VE and saved on NOS. 

GET_OBJECT_LIBRARY MYLIB 

SET LPROGRAM_ATTRIBUTES LOAD _MAP_OPTIONS=(BLOCKsENTRY_ POINT» SEGMENT 
CONVERTLOBJECTLFILE CITXTRS 

EXECUTE_TASK CITXTRS ‘program parameters!t LIBRARY=MYLIB 

PRINTLUFILE LOADMAP 


1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


Notes: 


o CLGO170 is NOS permanent file name for file containing CI 
object text for modules to be included in the library. 


o TITEXT180 is NOS/VE tocal File name for fliie containing II 
object text for modules to be inctuded in the Jibrary. 


o LIBRARY180 is NOS/VE tocal file name for the library being 
created. 


o IL1IB8170 is NOS permanent fite name for fite containing the 
fibrary. 


NOS/VE Job Commands 
CONVERT_LOBJECT_LFILE IITEXT180 CLGN170 
CREATE_OQBJECT_ LIBRARY 
ADD MODULE LIBRARY#IITEXT180 
GENERATE_LIBRARY LIBRARY=LIBRARY180 


OUTT 
REPLACE_LFILE LIBRARY180 ILIB170 DC=B56 


1.1.3 MODIFY A PREVIDUSLY SAVED OBJECT LIBRARY 


Notes: 
o ILIB170 is NOS permanent file name for file containing the old 
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library 


o LIBRARY18O is NOS/VE local file name for file containing the 
old library 


o CMOD170 is NOS permanent file name for file containing CI 
object text for the new module 


o NEWIIMQDULE Is NOS/VE jlocal file name for file containing II 
object text for the new module 


o. NEWLIBRARY is NOS/VE tocal file name for the library being 
created 


o NLIB170 is NOS tocal file name for new tibrary 
NOS/VE Job Commands 


SET_LOBJECT_LLIBRARY LIBRARY1I80 IL1I8170 
CONVERTLOBJECTLFILE NEWIIMODULE CMOD170 
CREATE_OBJECT_LIBRARY 

ADD MODULE LIBRARY=LIBRARY180 
REPLACE_MODULE LIBRARY=NEWIIMODULE 
GENERATE_LIBRARY LIBRARY=NEWLIBRARY 
QUIT 

REPLACELFILE NEWLIBRARY NLIB170 DC=B56 


1.21.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


Running from an interactive terminals enter: 


GETs»sfilename,. 
ROUTEsfilenamesDC=LP»FC=RH. 


The input file which Is sent to NOS/VE must be in 6/12 ASCII 
(or display code subset). The job file must be a single 
partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with users password and 
family name specified. Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_LFILE command. 
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121.5 PRINT A NOS/VE FILE 


At NOS/VE job termination the job tog will be automatically 
returned to NOS. The job tog will be appended to the NOS/VE 
output File OUTPUT. NOS/VE print files must be written by BAM as 
8/8 ASCII RT=V. Print files will be converted from 8/8 ASCII 
RT=V to NOS 8/12 ASCII when they are sent to NOS and will be 
printed in upper/lower case. 


Ali NOS/VE output files will appear in the NOS output queue 
(NOS HsO display) with the name IRHFxxx as a banner. In order to 
print a NOS/VE files the following command must be Issued within 
your job or be eantered from the system console via the operator 
facitity: . 


PRINT_FILE filename 
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220 COMMAND INTERFACE STATUS 


200 COMMAND_INTEREACE STALUS 


261 ACCESS_IO_NOS/VE_IN_DUAL_STATE 


2elel LOGIN TO NOS/VE 


To initially togin to NOS/VE via TAFs you must cause the first 
Jogin attempt to fall. This can be done by responding to the 
"FAMILY:™" © fogin prompt with something like? "s5»9". This must be 
done because the system will try to connect the terminal to IAF 
on the first login attempt no matter what is typed. To access 
TAF do the following on the second "FAMILY:" prompt: 


suserspasswords TAF 


You can access TAF from IAF by doing “"HELLOsTAF”™ or by 
answering TAF to the system prompt "APPLICATION:",. 


201.2 TERMINAL USAGE 


1) The stant (/) is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered {continuation 
lines are prompted with eef)2 The full ASCII character 
sets lower or upper case and all special characterss can be 
usedes 


2) A LOGDUT command will cause the NOS/VE Interactive Job to 
terminate. <A new NOS/VE Interactive Job can then be 
started by responding to the APPLICATION: * prompt with 
TAF. 


3) Terminal breaks (controt-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes a 
terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. When a 
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terminal is in pause break states two additional commands 
are available: ee 


RESUME_COMMAND =— resume execution at the point of 
interruption, 


TERMINATE_COMMAND = cause a terminate break condition as 
a terminate break had been entered. 


Both terminate break and pause break are available to programs 
as conditions via the program management condition mechanism. 


20123 NOS/VE PROGRAM ACCESS TO THE TERMINAL 


1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMPSGET_NEXKT or AMPSGET PARTIAL program 
interface which can be used by both task services and user 
ring programs. Interactive programs which use this 
interface should be able to handle both upper and =tIower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes. 


202 COMMAND_AND_ PARAMETER NAMES 


During the next few months a command supported by the system 
may not be in syne with your command interface document. The 
parameter descriptor table gives an accurates concise description 
of the command interface as currentiy supported. 


POT _Reader*s Guide 


The definition of a command's parameter fist is enclosed In 
parenthesis with a parameter description per tine. Each 
description has the general form: 


PARAMETER NAME? ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
VALUE 


Paraneter Names - describes the parameter name and any 
abbreviations. 


ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a tist of values Is possible. The value kind can be 


Cycte 5s July 1982 


| | 2-3 
NOS/VE Cycle 5 Helpful Hints 

| | | 07/07/82 
2.0 COMMAND INTERFACE STATUS | 

2.2 COMMAND AND PARAMETER NAMES 


further qualified. In some cases» the actual values allowed are 
described using the KEY notation. The value kinds include 
INTEGER» STRING» NAMEs FILE» STATUS. 


PARAMETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter. S$REQUIRED and SOPTIONAL are 
obvious. Other values in this position will be treated as iif 
they were entered by the user on command invocation. 


See the PROC command in the Command Interface ERS for more 
details. 


The POTs For the commands currentiy in the system can be 


displayed using the DISPLAY_COMMAND_INFORMATION command. This is 
documented in the nonstandard command section of this document. 


2¢3 COMMAND_FUNCTIONS 


Eunction atatus 

$M0D unchanged 
$C HAR unchanged 
SCLOCK unchanged 
$DATE unchanged 
$FILE unchanged 
SFNAME unchanged 
SINTEGER unchanged 
$NAME unchanged 
$ORD unchanged 
SREAL unchanged 
$STRING unchanged 
$STRLEN unchanged 
$STRREP unchanged 
S$SUBSTR unchanged 
SUNIQUE unchanged 
$TIME unchanged 
$VAR unchanged 
$SPECIFIED unchanged 
SSET_ COUNT unchanged 
SVALUE_COUNT unchanged 
SRANGE unchanged 
SPARAMETER_LIST unchanged 
SPARAMETER unchanged 
$STATUS unchanged 
$CONDITION unchanged 
$SEVERITY unchanged 
$PROCESSOR unchanged 
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MAND INTERFACE STATUS 
MAND FUNCTIONS 


$J0B 
SPROGRAM 


SYSTEM ACCESS COMMANDS 


Commands 


SETLLINK_ATTRIBUTES 
LOGIN 

LOGOUT 

SETLPASSWORD 
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unchanged 
unchanged 


Status 


unchanged 
unchanged - ¥*1 
unchanged 
unchanged 


The Family name of the job doing the submit will be used = as 


the default family name on batch jobs. 


The default for jobs 


submitted from NOS will be family SSYSTEM. This effectively 
means that whenever NOS/VE jobs are submitted from NOS the 


family parameter is required. 


RESQURCE_ MANAGEMENT 


Command 


REQUEST_UTERMINAL 


EILE_ MANAGEMENT 


Command 


SETLFILE_ATTRIBUTES 
COPY_FILE 

DISPLAY_FILE 

COMPARE _FILE 
DISPLAY_FILE_LATTRIBUTES 
SKIPLTAPE 


PERMANENT_EILE_ MANAGEMENT 
Conmanod 
GET_LFILE 


REPLACE_LFILE 
CREATELFILE 


atatus 


unchanged 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


status 

unchanged 
unchanged 
unchanged 
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ATTACH_FILE 
DELETE_FILE 
CHANGE_CATALOG_ENTRY 
CREATE_FILE_PERMIT 
DELETE_FILE_PERMIT 
CREATE_CATALOG 
DELETE_CATALOG 
DELETE_CATALOG_PERMIT 
CREATE_PERMIT_CATALOG 
DISPLAY_CATALOG 
DISPLAY_CATALOG_ENTRY 
SET_WORKING_CATALOG 


SCL_STATEMENTS_AND PROCEDURES 


Command 


PROC/PROCEND 
SETL-COMMAND_LIST 
DISPLAY _COMMAND_LIST 
REPEAT/UNTIL 
WHILE/WHILEND 
CREATE_VARIABLE 
DELETELVARTABLE 
BLOCK/BLOCKEND 

LOOP /LOOPEND 
FOR/FOREND 
TF/ELSEIF/ELSE/IFEND 
CYCLE 

EXIT 

WHEN/WHENEND 
CONTINUE 

CANCEL 

INCLUDE_FILE 

COLLECT TEXT 
DISPLAY_VALUE 
EXIT_LPROC 
ACCEPT_LINE 
INCLUDE_LLINE 
CREATE_LFILE_CONNECTION 
DELETE. FILE CONNECTION 


DISPLAY_FILE_CONNEC TION 


change HCS variable 
disptay HCS variabie 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


2-5 
07/07/82 


Cycle 5s July 1982 


NOS/VE Cycie 5 Helpful Hints 


209 COMMAND INTERFACE STATUS 
209 INTERACTIVE COMMANDS 


PO PO PORE PE BD BE PE PE PO OE FT OO 8 PE OD PO BA OE PE PG FO PE PE PO FE BE PO PO PE 98 BO PE PE PE D8 PE PE PO PO OE OE PE P08 TE PO PO PO PT PO PE OE OF O8 AE PE NO PO 8 FEE PE PE OE PE te Pt PO 


269 INTERACTIVE COMMANDS 


“Command 


RESUME_COMMAND 

TERMINATE COMMAND 
SET_TERMINAL_ATTRIBUTES 
DISPLAY_TERMINAL _ATTRIBUTES 
esc-e 

esc~l 

esc- j 

esc-t 

esc~x 


These commands are 


the Following meanings? 


Mt Gee me TD 


2010 QBLECT CODE MAINTENANCE 


Command 


CREATE_LOBJECT_LIBRARY 
DISPLAY_NEW_LIBRARY 

SELECT _DISPLAY_OPTION 

ADD MODULE 

REPLACE MODULE 

COMBINE MODULE 
CREATE_MODULE 

BIND MODULE 
CREATE_PROGRAM_DESCRIPTION 
DELETE MODULE 

CHANGE MODULE_ATTRIBUTE 
SATISFY_LEXTERNAL_REFERENCES 
REORDER_MODULE 
GENERATE_LIBRARY 
DISPLAY_OBJECT LIBRARY 
COMPARE _OBJECT_LIBRARY 
QUIT 

Ci to II Conversion 


entered 
escape keys characters carriage _return. 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
new ~— 1* 
new - 1* 
new —- 1* 
new - 1% 
new - 1* 


with the 


perform "display job _status™ command 
perform "display_log 10" command 
perform "disolay job _status ali™ command 
discard ali unprocesseds typed-ahead input 
terminate jobs but do not disconnect 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2e0 COMMAND INTERFACE STATUS 
2011 USER SERVICES 


2ell USER_SERVICES 


Command siatus 
DISPLAY LOG unchanged 
DISPLAY MESSAGE unchanged 


2el2 EILE_ ROUTING 


Command atatus 
HCS JMROUTE removed 


2.13 PROGRAM_EXECUTION 


¥*1 


*2 


*3 


Command aftatus 

SET PROGRAM_ATTRIBUTES new - *3 
DISPLAY_PROGRAM unchanged 
EXECUTE unchanged 
*name cali" unchanged - ¥*]1 
TASK/TASKEND unchanged 
TERMINATE_TASK unchanged 

WAIT unchanged 
SETL-DEBUG_RING unchanged 
DISPLAY_ACTIVE_TASKS new - *2 


Warning - “name cali" works onty for SCL procedures unless a 
SETFA command has been issued to specify that the 
FILE_CONTENTS are OBJECT and the FILE_GRGANIZATION ts DATA or 
LIBRARY.» The SETFA command must be reissued every time the 
file is brought over from NOS. The CONVERT_LOBJECT_LFILE>» 
SGETLOBJECT_LFILEs and GET _DBJECTULIBRARY nonstandard. commands 
issue the appropriate SETLUFILE_ATTRIBUTES command and are 
therefore recommended. 


Replace HCS TSTATUS command. 


Replaces SETLOBJECT_LIST and SET_PROGRAM_OPTIONS commands. 


2614 103 _ MANAGEMENT 


Command atatus 
SUBMIT_J08B unchanged 
DISPLAY _JOB_LSTATUS unchanged 
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TERMINATE _JQB unchanged 
PRINT_LFILE unchanged 
TERMINATE_PRINT unchanged 
DISPLAY_UPRINT_STATUS unchanged 


2015 NOSZVE_ COMMANDS IMPLEMENTED AS PROCS 


In this builds several NOS/VE commands have been implemented 
as SCL procedures in order to make the system look more tike the 
final version. Users are urged to use these procedures rather 
than their interim counterparts since the interim commands wilt 
ultimately be withdrawn. 


These procedures will be made available via the default system 
prolog. 


2o16 NON-STANDARD COMMANDS 


The following commands provide aononstandard means of 
performing various frequently performed functions. They will be 
Superceded in subsequent builds by standard commands and 
capabilities. 


2216.1 DELETE_CATALOG_CONTENTS ¢$ DELCC 


The purpose of this command is to delete all entries from the 
specified catatog. This inctudes subcatalogs and the files they 
contain. ; 


delete_catalog_contents [catalog=<catalog>] 
Cstatus=<status variable>] 


catalogic: This parameter specifies from which catalog al! 
files are to be deleted. Omission will cause 
the current working catalog to be used. 


status: See ERROR HANDLING. 
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2216.2 DISPLAY_ACTIVE_TASK ! DISAT 


2el6.2 DISPLAY_LACTIVE_LTASK $ DISAT 


The purpose of this command Is to disptay task statistics for 
all currently active tasks in a job. The following information 


is displayed. 
task name 
execution 
number of 


disotay_active_task 


time use 
page fauits 


Coutput=<Ffille>] 
{status=<status variable>] 


outputic: This parameter specifies the file to which the 


task 


statistics is displayed. Omission will 


cause $OUTPUT to be used. 


2el6e3 DISPLAY_SYSTEM_LDATA { DISSD 


The purpose of this command is to display system page fault 
statistics and system monitor request statistics. 


display _system_data 


display_option:; 


display formats 


[display_option=page_faultsipf 
smonitor requestsimriall 

Cdisplay_format=incrementaliiitotaiit] 

Coutput=<file>] 

Cstatus=<status variable>] 


do: This parameter specifies which 
statistics are to be displayed. The 
following options are allowed : 


page_faults - display the page 
fault statistics. 


monitor requests - display the system 
monitor request 
statistics. 


Gmission will cause ALL to be 
usede 


df: This parameter specifies whether a 
display of the ail statistics recorded 
so far (total) or only those statistics 
recorded since the last 
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display usystem data command 
(incremental) should be displayed. 
Omission will cause incremental to be 


usede 
outputio: This parameter specifies the file to 
which the system data will be 


displayed. Omission will cause $OUTPUT 
to be used. 


status? See ERROR HANDLING, 
2elbe4 DISPLAY_JOB_DATA $ DISJD 


The purpose of this command Is to display the following job 
related statistics: 


time in job mode 

time in monitor mode 

count of page in operations 
reclaimed pages 

new oages assigned 

working set size 

count of ready tasks 


display _job_data [display_option=job_data] 
(display _formatz=incrementalitiitotalit] 
Coutput=<filte>] 
{status=<status variable>] 


display_optionido: This parameter specifies which 
statistics are to be displayed. The 
Following options are allowed? 


job data - display job related data. 


Omission will cause job data to be 
used. 


display _formatidf: This parameter specifies whether a 
display of the al! statistics recorded 
so far (total) or only those statistics 
recorded since the last display _job_data 
command (incremental) should be 
displayed. Qmission will cause 
incremental to be used.s 
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201604 DISPLAY_JOB_LDATA { DOISUD 


outputio: This parameter specifies the file to 
which the job data will be displayed. 
Omission will cause $OUTPUT to be used. 


status? See ERROR HANDLING. 
2016.5 DISPLAY_COMMAND_INFORMATION 3 DISCI 


The purpose of this command is to display current information 
about a NOS/VE command, The parameter namess abbreviations, 
allowed values and known problems for a commands as supported In 
the current systems can be determined. This is a nonstandard 
command and will be repiaced by the help utility sometime in the 
future. | 


display _command_information command name=<Cnamediail 
Cutitity name=create_object_tibrary; 
colftsource code_utilityiscuisystem] 
Cdisplay_option=parameter_description_table: 
pdtinotesinamesihelo] 
[Toutput=<file referenced] 
Cstatus=<status variable>] 


command _nameitcn: This parameter specifies the name of the 
command about which information is to be 
displayed. 


utifity _nametun: This parameter specifies which utility the 
command belongs to. Omission will cause 
SYSTEM to be used. 


display_optionitdo: This parameter specifies the type of 
display being requested. The options are: 


parameter _description_tableipdt - selects 
a display of the parameter descrip- 
tion table used by the command when 
executed. 


notes - selects a display cf any known 
problems with the command. 


names - selects a disptay of the command 
names for a utility. 


help - selects a display of the command 
interface description of the command. 
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2016.25 DISPLAY_ 


COMMAND_INFORMATION ¢ DISCI 


outout} 


status: 


Omission will cause PDT to be used-e 

0: This parameter specifies the file to which 
information will be displayed. Omission 
wil} cause S$NUTPUT to be used, 


See ERROR HANDLING. 


2216.6 CONVERT_LOBJECT_LFILE § CONOF 


The purpose of this command is to get a NOS/VE object file 


produced on 
processing 
commands. 


NOS and to convert it to an object file suitabte for 
by the NOS/VE toader or object code maintenance 


convert object _file to=<file reference> 


fromif: 


usersu: 


status: 


Cfrom=<name>d ] 
Cuser=<name>] 
C[status=<status variable>] 


This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 


This parameter specifies the name of the NOS file to 
be converted. This is the permanent file name as 
defined In the NOS file system and can be up to seven 
characters in tength. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
neccessary if the file is in a catatog other than the 
user who was specified by the most recently issued 
SETLLINK_ ATTRIBUTES command. 


See ERROR HANDLING. 


2el6e7 GETLOBJECTLFILE : GETOF 


The purpose of this command is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allon the object file to be used by 
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NOS/VE. 


get l_object_file to=<file reference>d 
| Cfrom=<name>d] 
CLuser=<Cname>] 
Cstatus=<status variabte>] 


toit? This parameter specifies the NOS/VE file name of the 
object file. 


fromif: This parameter specifies the NOS file name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to sewen characters in 
length. 


Omission will cause the permanent file name of the 
TQ parameter to be used. 


useritu: This parameter specifles the NCS user tdentification 
of the owner of the file. This parameter is only 
necessary if the File is in a catalog other than the 
user who was specified by the most recently issued 
SETLLINK_ ATTRIBUTES command. 


status: See ERRGR HANOLING. 
2016.8 GET_LOBJECT_LIBRARY $ GETOL 


The purpose of this command is to get a previously created 
NOS/VE object tibrary from the NOS side and set the appropriate 
File attributes that will allow the object tibrary to be used on 
NOS/VE. 


get _object_library to=<file reference> 
{from=<Cname>] 
Cuser=<name>] 
C[status=<status variable>] 


toit: This parameter specifles the NOS/VE file name of the 
object library. 


fromi3f: This parameter specifies the NOS file name of the 
object File. This ts the permanent file name as 
defined in NOS and can be up to seven characters in 
length. 
Qmission will cause the permanent file name of the 
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TO parameter to be used. 


userj;u: This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
necessary if the File is in a catalog other than the 
user who was specified on the most recently issued 
SETLLINK_ ATTRIBUTES command. 


status: See ERROR HANDLING. 


2016.9 DISPLAY_LOBJECT_LTEXT ¢{ DISOT 


The purpose of this command is to produce a formatted disptay 
of the object text contained In an opsece file or object library 
produced on NOS/VE. 


siSplay Be jeck. exe file=<file> 
Coutput=<file referenced] 
Cstatus=<status variabte>] 


fileif: This parameter specifies the object file or object 
fibrary containing the object text to be listed. 


outputio: This parameter specifies the file to which the 
disolay is to be written. 


Qmission will cause the file $OUTPUT to be used. 


status: See ERROR HANDLING. 


2016610 GETLSOURCE_LIBRARY ¢ GETSL 


The purpose of this command is to get a previously created SCU 
source fibrary from the NOS side and set the appropriate file 
attributes that will allow the source tibrary to be used on 
NOS/VE. 


get _source_library to=<file referenced 
{from=Cname>] 
{fuser=<name>] 
Cstatus=<status variable>] 


toit: This parameter specifies the NOS/VE file name of the 
source ‘Jtbrary. 
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fromif: This parameter specifies the NOS file name of the 
source library. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
fength. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


usertus This oarameter specifies the NOS user identification 
of the owner of the file. This parameter Is only 
necessary if the file is in a catatog other than the 
user who was specified on the most recentiy issued 
SETLLINK_ATTRIBUTES command. 


status: See ERRNR HANDLING. 


2016.11 EDITLFILE : EDIF 


The purpose of EDITLFILE is to Initiate the execution of the 
SCU editor on a text file. (For details see ARH3883,.) 


edit _fiie i edif - edit lines on a source file. (procedure file 
not necessarily in its final form) 


parameters defauits 
file=file(source) $REQUIRED 
Cfresult=fite(source)] S$VALUE( FILE) 
Cinput=file reference ] $COMMAND 
Coutputzfiie reference] $OUTPUT 
[status] 


2e16.12 JEDIT 


The purpose of this command is to initiate execution of the 
JEDIT editor bullt by Jack Bohnhoff. Anyone wanting information 
about the editor should contact Jack. 


jedit frome<file> 
Cstatus=<status variable>] 


fromif: This parameter specifies the file to be editted. 


This file is rewritten after the editor 
terminatess 
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status: See ERRGR HANOLING in the NOS/VE Command 
Interface. 


2016013 DEBUG 


The prototype R1 NOS/VE debugger is now available. Details on 
how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and Userts. 
Guide™, Sunnyvale DCS number $4028. 


20160614 SETLLINK_LATTRIBUTES 3 SETLA 


The SET LLINK_ATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional (and In fact not useful in 
the current environment since we disable that feature on the NOS 
side). 
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3.0 PROGRAM_INIEREACE STATUS 


The 'status' column indicates whether the procedure is 
unchanged from the previous builds modified from the previous 
build or not available in this bultd. Footnotes are numbered 
within each section. 


321 COMMAND PROCESSING 


Procedure status 
CLPSSCAN_PARAM_LIST unchanged 
CLPSTEST_PARAMETER unchanged 

CLPSGET KEYWORD unchanged 

CLPSGET_LSET_ COUNT unchanged 
CLPSGET_VALUE_COUNT unchanged 
CLPSTEST_RANGE unchanged 
CLPSGET_VALUE unchanged 
CLPSCREATE_VARTABLE updated to ERS Rev. 8 
CLPSDELETE_VARIABLE updated to ERS Rev. 8 
CLPSREAD_ VARIABLE updated to ERS Rev. 8 
CLPSWRITE_ VARIABLE updated to ERS Reve. 8 
CLPSSCAN_COMMAND_FILE unchanged 

CLPSEND_ SCAN _COMMAND_FILE unchanged 
CLPSSCAN_COMMAND_LINE unchanged 
CLPSCREATE_LFILE_ CONNECTION unchanged 
CLPSDELETE_LFILE_CONNECTION unchanged 
CLPSPUSH/POP_UTILITY unchanged 
CLPSGET_COMMAND_ORIGIN unchanged 
CLPSGET_DATA_LINE unchanged 
CLPSSCAN_PROC_DECLARATION unchanged 

302 MESSAGE GENERATOR 

Procedure status 

OSPSFORMAT MESSAGE unchanged 
OSPSSET_LSTATUS_ ABNORMAL unchanged 
QSPSAPPEND_STATUS_PARAMETER unchanged 
QSPSAPPEND_STATUS_INTEGER unchanged 
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363 RESOURCE. MANAGEMENT 


Procedure Status 
RMPSREQUEST_MASS_STORAGE unchanged 
RMPSREQUEST UL TERMINAL unchanged 


All terminal attributes can be specified on the 
RMPSREQUEST U TERMINAL call but only the following are operational: 


auto_input 
transparent_mode 
prompt_file 
prompt ustring 


oo U8 6 


Files assianed to a terminal device can be accessed via the 


following BAM requests: 


AMPSOPEN 
AMPSGET_NEXT 
AMPS$GET_DIRECT 
AMPSGET_PARTIAL 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMP SPOUT PARTIAL 
AMPSCLOSE 
AMPSREWIND 
AMPSSKIP 
AMPSSEEK_DIRECT 


oo O90 O GO 8 080 8 


344 PROGRAM_EXECUTION 


Procedure atatus 

PMPSEXIT unchanged 
PMPSEXECUTE unchanged 
PMPSTERMINATE unchanged 
PMPZAWAIT TASK TERMINATION unchanged 
PMPSMODULE_TABLE_ADDRESS unchanged 
PMPSENTRY_POINT_TABLE_ADDRESS unchanged 
PMPSPUSH_TASK_DEBUG_ MODE unchanged 
PMPSSET_TASK_DEBUG_ MODE unchanged 
PMPSTASK_DEBUG_MODE_ON unchanged 
PMPSSET_DEBUG_RING unchanged 
PMPSDEBUG_RING unchanged 
PMPSCHANGE_ DEBUG_LIBRARY_LIST unchanged 
PMPSPOP_TASK_DEBUG_MODE unchanged 
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3.5 PROGRAM COMMUNICATION 


Procedure status 
OSPSAWAITLACTIVITY_COMPLETION unchanged 
PMPSDEFINE_QUEUE unchanged 
PMPSREMOVE_ QUEUE unchanged 
PMPSCONNECT_ QUEUE unchanged 
PMPSDISCONNECT_QUEVE unchanged 
PMPSSEND_ TO_QUEUE unchanged 
PMPSRECEIVE_FROM_QUEUE unchanged 
PMPSSTATUS_QUEUVE unchanged 
PMPSSTATUS_QUEVES_DEFINED unchanged 
PMPSGET_QUEUE_LIMITS unchanged 
3.6 CONDITION PROCESSING 
Procedure atatus 
PMPSESTABLISH_CONDITION HANDLER Added support of detected 
uncorrected error 
PMPSDISESTABLISH_COND_HANDLER unchanged 
PMPSCAUSE_CONDITION unchanged 
PMPSCONTINUE_TO_LCAUSE unchanged 
PMPSTEST_CONDITION_HANDLER unchanged 
PMPSVALIDATE_PREVIOUS_SAVE_AREA unchanged 
PMPSESTABLISH DE BUG_DFF unchanged 
OSPS$SETLUSTATUS_FROM_CONDITION unchanged 
307 PROGRAM SERVICES 

Procedure atatus 
PMPSGENERATE_UNIQUE_NAME unchanged 
PMPSGET_TIME unchanged 
PMPSGET_MICRGSECOND_CLOCK unchanged 
PMPSGET_LTASK_CP_TIME unchanged 
PMPSGET_DATE unchanged 
PMPEGET_LUSER_IDENTIFICATON unchanged 
PMPSGET_LACCOUNT_PROJECT unchanged 
PMPSGET_JOB_NAMES unchanged 
PMPSGET_JOB_ID unchanged 
PMPSGET_JOB_MODE unchanged 
PMPSGET_ PROGRAM unchanged 
PMPSGET_TASK_ID unchanged 
PMPSMANAGE_SENSE_SWITCHES unchanged 
PMPSGET_OS_VERSION unchanged 
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PMPSGET_PROCESSOR_LATTRIBUTES 


unchanged 
PMPSDEFINE_ DEBUG_ENTRY unchanged 
PMPSGET_DEBUG_LENTRY unchanged 
PMPSMODIFY_DEBUG_ENTRY unchanged 
PMPSREMOVE_DEBUG_ENTRY unchanged 

368 LOGGING 
Procedure atatus 
PMPSLOG unchanged 
PMPSLOG_ASCII unchanged 
3.9 ELLE_MANAGEMENT 

Procedure status 
Sequential Access unchanged 
Byte _Addressable Access unchanged 
Record Access unchanged 
Segment Access unchanged - ¥*1 
V_System Specified unchanged 
V_User Specified unchanged 
U_System Specified unchanged 
Y_User Specified unchanged 
F_System Specified unchanged 
FLUUser Specified unchanged 
AMPSDESCRIBE_NEW FILE deleted 
AMPSFILE unchanged 
AMPS$GET_LFILE_ATTRIBUTES unchanged 
AMPSFETCH unchanged 
AMPSSTORE unchanged 
AMPSCDPY_FILE unchanged 
AMPSRENAME unchanged 
AMPSRETURN_FILE new name 
AMPSOPEN unchanged 
AMPSCLOSE unchanged 
AMPSFETCH_ACCESS_INFORMATION unchanged 
AMPSSKIP unchanged 
AMPSREWIND *2 
AMPSWRITE END PARTITION unchanged 
AMPSGET_NEXT unchanged 
AMPSGET DIRECT unchanged 
AMPSGET PARTIAL unchanged 
AMPSPUT_NEXT unchanged 
AMPSPUT_DIRECT unchanged 
AMPSPUT_PARTIAL unchanged - *3 
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*1 


#2 


¥*3 


AMPSSEEK_ DIRECT unchanged 
AMPSGET SEGMENT _ POINTER unchanged 
AMPSSET_SEGMENT_EOT unchanged 
AMPSSET USEGMENT_POSITION unchanged 
AMPSSET_LLOCAL_NAME_ABNORMAL unchanged 
AMPSSETLUFILE_LINSTANCE_ ABNORMAL unchanged 
AMPSACCESS_ METHOD unchanged 
AMPSFETCH_ FAP_POINTER unchanged 
AMPSSTORE_FAP_LPDINTER unchanged 


Segment access If a segment access file is written and = an 
AMPSSETLUSEGMENT_LEOI is not Issued to record the ENIs EDI 
remains zero. The highest page referenced is not yet used as 
the default ENI. This particularity affects those who wish to 
make heaps permanent because EDI is always zero for a heap. 


AMPSREWIND The WAIT parameter on the procedure call is not 
supported. 


AMPSPUT_LPARTIAL PUT PARTIAL with the TERM_OPTION = 
AMCSTERMINATE does not act as a put lnext if a preceding START 
was not issued. 


3.10 PERMANENT _EILE MANAGEMENT 


Procedure ~ status 

PFPSDEFINE updated to ERS Reve 9 
PFPSATTACH updated to ERS Rev. 9 
PFPSPURGE updated to ERS Reve 9 
PFPSCHANGE updated to ERS Rev. 9 
PFPSPERMIT updated to ERS Rev. 9 
PFPSDELETE_PERMIT updated to ERS Reve. 9 
PFPSDEFINE_ CATALOG updated to ERS Reve 9 
PFPSPURGE_CATALOG updated to ERS Reve 9 
PFPSPERMIT_ CATALOG updated to ERS Rev. 9 
PFPSDELETE_CATALOG_PERMIT updated to ERS Rev. 9 


3e11 MEMORY MANAGEMENT 


MMPSADVISE_IN unchanged 
MMPSADVISE_OUT unchanged 
MMPSADVISE_OUT_IN unchanged 
MMPSWRITE MODIFIED_PAGES unchanged 
MMPSCREATE_SEGMENT unchanged 
MMPSDELETE_SEGMENT unchanged 
MMPSSTORE_SEGMENT_LATTRIBUTES unchanged 
MMPSFETCH SEGMENT_ATTRIBUTES unchanged 
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MMPSVERTIFY_ACCESS unchanged 

MMPSFREE unchanged 

MMPSLOCK_ PAGES number of locked pages per 
MMPSUNLOCK_PAGES segment restricted to 32 
MMPSFETCH_PVA_LUNWRITTEN_PAGES unchanged 


3el2 STATISTICS EACILITyY 


SFPSESTABLISH_ STATISTIC unchanged 
SFPSENABLE_STATISTIC unchanged 
SFPSDISABLE_STATISTIC unchanged 
SFPSDISESTABLISH_STATISTIC unchanged 
SFPSEMIT STATISTIC unchanged 
SFPSEMIT_SYSTEM_STATISTIC unchanged 


3213 INTERACTIVE FACILITY 


IFPSTERMINAL unchanged 
IFPSFETCH_TERMINAL unchanged 
IFP$STORE_TERMINAL unchanged 
IFPSGET_DEFLT_TERMINAL_ATTRIBUTES unchanged 
IFPS$GET_TERMINAL_ATTRIBUTES unchanged 
TFPSADVANCE new - ¥*1 


*1 Oniy the option IFCSADVANCE_ALL_QUEUED_ODUTPUT is supported. 


3414 NOSZVE_EXCEPTIONS 


The following summarizes the exception code ranges currentiy 
assigned to NOS/VE. These code ranges represent ae finer 
breakdown than the one specified in the SIS for internal NGS/VE 
development purposes.» Howevers it is important to remember that 
only the product identiflers documented in the SIS may appear in 
error messagese 


Common Modules 99000 —- 93999 
Common Code Generator BsC60 - 8,999 
Product 
Exception Code Identifier Product Name 
1 - 158999 Reserved 
1599000 —- 15939999 SY System Core 
1609000 —- 16939999 AM Basic Access Methods 
160000 = 16339999 BA Basic Access 
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1649909 -— 1643999 LN Local Name Mgr 
16539000 - 1655999 JF Job File Mgr 
166,000 ~— 1663999 SR Conversion Services 
1672000 — 167999 CM Configuration Mamt 
1702000 - 1799999 cL Command Language 
180,000 ~— 1893999 JM Job Management 
1909000 - 1999999 LL Loader 
2009000 = 2099999 MM Memory Management 
2002000 — 20439999 MM Monitor Level 
2052000 =— 2055999 MM Task Level 
21029000 = 2199999 0$ Qperating System 
2109000 — 2109999 os 0s 
2112000 — 2119999 MT EXEC 
2122000 — 2123999 Io MS 1/0 
2139900 —- 2132999 10 Tape I/0 
2142000 =- 21439999 DM Device Management 
2152000 = 21539999 ML Memory Link 
2169000 — 2162999 IF Interactive 
2179000 — 2172999 T™M TM Monitor 
2182000 — 21839999 ™ TM Task 
2192000 — 2199999 JS Job Swappers 
2209000 — 22939999 PF Permanent File 
Management 
2219000 - 2219999 ST Set Management 
2229000 — 2229999 PU Permanent File Utilities 
2309000 — 2399999 PM Program Management 
24029000 — 2493999 RM Resource Management 
2502000 —- 2599999 OF Operator Facitity 
2609000 — 2699999 AV User Administrator 
2709000 — 2799999 Ic Interstate Communication 
2802000 — 2899999 RH Remote Host Facility 
2909000 = 2999999 oc Object Code Utilities 
3009000 — 3099999 DB Deadstart/Recovery 
310,000 —- 3193999 MS Maintenance Services 
3209000 — 3299999 Reserved 
3403000 — 3499999 SF Statistics Fac. 
33023000 —- 3399999 YS User Errors 
500000 =- 5092999 AA Advanced Access Method 
510,000 —- 5195999 AG ALGOL 
5202000 —- 5299999 AL Assembly Language 
5302000 - 5395999 AP APL 
5402000 ~- 5495999 BA BASIC 
5502000 = 5599999 CA Conversion Aids System 
5609000 - 56939999 CB COBOL 
5702000 =— 5799999 CY CYBIL 
580s000 —- 5899999 FT FORTRAN 
5902000 - 5999999 PA PASCAL (Wirth) 
600,000 —- 6099999 Pl PL/1 
6109000 -— 61923999 SM Sort Merge 
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6209000 —- 6293999 $c Source Code Utility 
640,000 —- 6499999 DB Debug 
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4.0 DUAL STATE DEADSTART AND OPERATION 


. 


4.0 QUAL_SIATE_DEADSTART_AND_OPERATION 


4o1 CURRENT _DUAL_STATE_CONEIGURATION 


The 


Arden Hills S2 development systems are configured to run 


with three FMD units. 


o 6©FMD Unit 43 


This unit contains the following: 


A170 NOS (523 as released)» CTIs MSL» EI binaries» NOS 
deadstart files 

Files associated with user name LIBRARY 

Files associated with user name SES 

Files associated with DEV1ls DEV2,» RELIs INT1. 


o FMD Unit 41 


This unit contains the following: 


Files required to deadstart dual state Cycie 33 A170 NOS 
(5.3 pius changes necessary for Cycie 3)5 CTI» MSL» EI 
binariess and NOS Deadstart files. 
It is also used as a temp device. 


o FMD Unit 42 


This unit contains the following: 


NOS/VE Development Area PL*'s and Member PL'*s 

NOS/VE Deadstart Files to be tested (saved in individual 
user's catalogs) 

Files associated with user name INT2 


o 6©FMD Unit 44 


This is another NOS PF device. 


o FMD Unit 45 


This is another NOS temp device. 
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4.2 USER _NAMES_AND_PERMANENT_EILES 


1) The convention used for creating user names on NOS/VE is as 
follows: 
o Your user name will be your initials. 
o Your password will be these 3 fetters followed by the 
fetter "xt, 
o You must see COMSOURCE (UR.K. Cooper - x3092) to be 
assigned a user index 


2) PF dumping and toading 


You may use "SES.sDUMPPE™ on SN/101 to dump your permanent 
files to tapes and then toad them onto your user name on A170 
NOS using “"SES.~LGADPF™. Documentation on how to use these SES 
procedures and what their parameters are is included in the 
SES User's Guides or they can be obtained by typing: 


SESsHELP.DUMPPF and SESsHELP.LOADPF. 
403 ID_RELOQAD CONTROLWARE FOR THE NOSZVE_ DISK DRIVER 


At deadstart time NOS wilt automatically load 7155-1x disk 
controtware on one channel with controlier type=FM (LBC CMRdeck 
entry)s and will automatically load 7155-4x disk controltware on 
any channel with controfiler typezHT (LBC CMRdeck entry). NOS/VE 
supports both of those types of controttiers. NOTE: It is not 
possibie to use 844 half-track controlware in this environment. 


404 A17O_NOS_DEADSTART 


4.4.1 CTI AND CHECKING CENTRAL MEMORY 


Deadstarting A170 NOS assumes some knowledge of CTI. CTI 
stands for Common Test and Initialization. It is software that 
places an 800 series machine In a state such that it is possible 
to deadstart an operating system. CTI ts used somewhat 
ambiguous!ty in the software community to imply CTI and MSL 
(Maintenance Software Library). The MSL is a collection of 
programs and data that inctudes such things as a subset of CMSE 
(Cyber Maintenance Software Executive) that enables one to toad 
controlware to controllerss took at CYBER 180 maintenance 
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registers» fook at microcodes etc. The MSL atso contains 
microcode that can be loaded by CTI. The MSL Is actually an 
operating system that runs independentiy of NOS. An important 
element of CTI/MSL Is HIVS (Hardware Verification Sequence), 
which is a program that floads microcodes clears and checks 
central memory and tests all 170 opcodes. If you are not sure 
what the machine was used for (particularly the first hands on 
user each morning) then the HIVS program should be run. This is 
accomplished by: 


1) deadstart to NOS/VE Cunit 40 for $3» unit 41 for $2) 
2) Enter 0 (oceraved intervention) 
3) Enter P (deadstart panelsmake sure level 0 deadstart) 
4) <BKSP> 
5) Enter H (assure yourself that CS=YES to reload microcode) 
6) <A&KSP> 
7) Enter V (verification sequence) 
8) Hit <CR> at "parameter display* to test CM & CP 
When you see text that tells you that verification is complete 


and a deadstart is reguireds you are now ready to deadstart NOS. 


42422 NOS DEADSTART 


See Section 3.3 of the Integration Procedures Notebook § for 
important NOS CMRDECK changes. 
o Sat the D/S panel to deadstart from the primary system disk. 
This is Unit 41 for all Cycle 2 systems. 
o Push D/S button 
o Enter (CR) 
o Enter date/time 


Wait for deadstart to complete. 
Notes The deadstart tape DUAL34 (which is currently installed on 


unit 41) is found in the area in the northeast corner of the $2 
fab where the tape cabinet Is found. 


Cycle 5s July 1982 


4-4 
NOS/VE Cycte 5 Heipful Hints 
4.90 DUAL STATE DEADSTART AND OPERATICN 
404.3 INITIALIZING AN 855 (5$3) 


40403 INITIALIZING AN 855 ($3) 


If an 855 ts powered down (processor) it may be impossible to 
deadstart or even run the HIVS program. The reason is that 
powering up does not master clear the maintenance channel. This 
is a known probiem and is being addressed by CDED. The way to 
solve this -problem currentiy is to used the CMSE equivalent of 
the HIVS programe That program can be executed by performing = an 
alternate deadstart to the engineer's/CE's CMSE packs entering M 
{to select maintenance)» entering a CR at the menu screens = and 
then entering 'GOD INIT39%., INIT39 fs a CMSE command buffer and 
will require about 2 to 3 minutes to complete. When the display 
shows a "TR! (terminate buffer) the initialization is complete. 
The 39 stands for a microcode cycles ise. the 855 is currentiy 
using cycie 39 microcode. 


405 NOSAVE DEADSTART_AND_INSTALLATION 


o Enter DOWNsCH2. so NOS/VE can use the channel. 
o Enter DOWN»sCH32.2 so NOS/VE can use the channel. 


o The following file must be available in your catalog on the 
$23 


TPYXKXK contains a NOS/VE deadstart image. This must be a copy of 
the dual state deadstart images availabite from the tink 
procedures. 


o If you've never deadstarted NOS/VE from the user number = § from 
which you want to run or if you wish to change the current 
parameter settings for your particular user numbers then do a 
SETVE. SETVE assumes the file TPXXXK is in your user number; 
you do not have to do another SETVE if TPXXXK has changed 
since the fast time you rane The general form of SETVE is: 


XeSETVECPN=FFFFsUN=unsC=6) 


where FfFff is an identifier of up to 4 characters and un is 
the user number to search first for files. 6 is the number of 
the system core command deck for the Arden Hills 
configuration. In general fffFF and un will be the sames e8e9- 
X»SETVE(DAHs UN=DAH»C 26) 


**Oniy OQNE SETVE should be done for each user number and a 
SETVE should NOT be done for ANY Integration user number 
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except by the Integration pro ject.** 
SEE SECTION 5.1 FOR MORE DETAILS. 

o Bring up dual state: 
NNVEFFFF. 


where nis any contro! point number except 122 and the 
BATCHIO»s MAGNET & SYSTEM control points and (*ffff is the 
identifier specified in SETVE,s, e.g %4&eNVEINTI. 


o0 Bring up the Gperator Facility 
Enter kK»sn - where n is the control point of the NVE job. 


NOS/VE is currently generated and initialized on both NOS 
and NOS/VE. All source and object libraries that make up the 
NOS/VE system are produced on NOS and therefore must be 
converted from their CI to II counterparts. Other parts of 
installing and initializing the system (eeg. building the 
S$SYSTEM catalog) are performed by command language procedures 
on NOS/VE. Since the same system will many times in a closed 
shop environments» it is advantageous to only perform the 
conversion from CI to II a single time} save the results In 
the NOS fife system and then simply bring the files back 
during deadstart. 


The actual files that get instatied and toaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to initialize their NOS/VE environment 
in the most suitable fashion. The process of building the 
System profile and of performing the CI to II conversions is 
referred to as an instalttation deadstart and the process of 
executing the system profile and of fetching previousty 
converted files from NOS and making them available in the 
NOS/VE file system Is referred to as a deadstart. A single 
command is availabie to perform both an installation deadstart 
and a deadstart. 


4.5.21 THE DS PROCEDURE 
The purpose of this command is to perform an instaltations 
normal or recovery deadstart of NOS/VE. The defaults for 


Parameters are those most convenient for "closed shop" 
deadstarts. 
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The procedure "brings up™ the job log display on the teft 
screen where the progress of the procedure may be watcheds and 
the control point display on the right screens Just before 


the 


procedure changes the feft screen to display the system 


Jog and writes to that log the message: 


tm——-— Deadstart Completed ----1 


at which point the operator may enter commands. 


ds (kind=instali { normal ? recover] 
Caget_source_libraries=<boolean>d] 
Caet_products=<boolean>] 
Cecho=<hoolean>] 
Caiternate_user=<NOS_user name>] 
[save_install files=<boolean>]. 
(validate _users=<boolean>] 
Cquick validate=!list of <name>] 
Cdebug=<Cboolean>] 
Chelp=<file reference>d] 
Cstatus=<status yvariable>] 


kind 


3} k: This parameter specifies what kind of deadstart is 
to be performed. Vatid specifications are: 


install 3 i - installation deadstart to be performed. 
The system tibraries are buiit from CI object 
files. 


normal ; on - normal deadstart to be performed. The 
system tibraries are obtained from the results of a 
previous Installation deadstart. 


recover {fr - recovery deadstart. Just initiates system 
tasks. Permanent files are "recovered" froma 
previous run of the system. 


Qmission aid cause a recovery deadstart to be 
performed. 


get _source_ftibraries i gsl?: This parameter specifies whether 


SCU Jibraries are to be installed. Valid specifications 
are: 


true } yes { on ~- {t{tbraries are to be instalied 
faise { no } off —- ftibraries are not to be installed 


Cycte 5s July 1982 


te ie 


4-7 
NOS/VE Cycle 5 Helpful Hints 
07/67/82 


4.0 DUAL STATE DEADSTART AND OPERATION 
4.521 THE DS PROCEDURE 


On the Arden Hills ctosed shop S2 systems the SCU 
libraries to be Installed are: . 


OSFPIL -—> OSFSPROGRAM_LINTERFACE_LIBRARY: operating system 
program interface 


OSFSL —-> OSFSSOURCE_ LIBRARY? subset of operating system 
source library 


Omission will cause SCU libraries to be instalied. 
get_oroducts : gp: This parameter specifies whether the object 
libraries defining the current product set are to be 
Installed. Valid specifications ares 
true } yes } on — the products are to be installed 


faise { no : off - the products are not to be installed 


Qn the Arden Hills closed shop $2 systems the product 
set to be instailed consists of: 


CYFIIC -> CYFSCOMPILER: cybil II compiter 


CCFRTL =-> CCFSRUN_TIME_LIBRARY: common compiler modutes 
run time library 


MLFRTL -> MLFSRUN_TIME_LIBRARY: math run time fibrary 
DBFDL -> DBFSDEBUG_LIBRARY: symbolic debug tibrary 
SCFOL => SCFSOBJECT_LIBRARY: source code utility 


SCFCL -> SCFSCOMMAND_LIBRARY: source code utility 
"stand-alone" command tibrary 


IFFEDIT -> IFFSEDITOR: Jack Bothnhoff's editor (JEDIT) 
Omission will cause the product set to be installed. 
echo } e@: This parameter specifies whether the commands should 
be echoed to the consote during execution. Valid 
specifications are: 
true { yes i on — echo commands 
fatse ino: off - do not echo commands 


Qmisstion will cause commands not to be echoed. 
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alternate_user i au: This parameter specifies what NOS user to 
check if the default NVE user does not have the needed 
file. Any NOS user name Is allowed. 


Omission wit} cause INT1 to be used. 
save_instali files : sif: This parameter specifies whether to 
save the system tlibraries created by an instailation 
deadstart. This parameter is ignored for a normal or 
recovery deadstart. Valid specifications are? 
true i yes } on ~ save the installed system libraries 


false { no 3} off - do not save the installed system 
fibraries 
DOmission will cause the files not to be saved. 
validate_users 3 vu: This parameter specifies whether to run 
the job that validates NOS/VE users. This parameter is 
ignored for a recovery deadstart. Valid specifications 
are; 
true $} yes } on ~- run the validation job 
false { no ! of Ff - do not run the validation job 
Omission will cause the validation job to be rune 
quick validate {i qv: This parameter determines which users 
will be validated by the validation job if it ts rune 
When specifieds this parameter gives a list of user names 
to be validated in addition to the users: INTls INT2s 
DEV1l»s DEV2» RELI» EVAL and RKC. 
Omission will cause aff’ users to be validated. 
debug $$ d: This parameter specifies whether the procedure 
should abort if an error condition is detected. Valid 
specifications are: 
true  : yes i on =- do not abort on an error. The user 
wild be prompted for commands in the event of = an 
error at which time entering “continue” will cause 
processing to resume. 
faise i} no {! off - abort on an error 
Omission will cause the procedure to abort when an 
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error is encountered. 


help | h: This parameter specifies whether help information is 
to be written. If this parameter is specified» the hetp 
information wlll be written to the specified fite and the 
procedure will terminate. 


Omission will cause the procedure to execute and the 
help information not to be written. 


status: See ERROR HANDLING in the NOS/VE ERS. 


If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files 
CYBILGOs, xXLJOCM, XLJOSL, XLJLIB and XLJEC)» or you must use 
the alternate_user parameter to specify a NOS catalog 
containing the files (e.g. DEVI). 


AVMUTIL CLMDP DMMDISA ICMCLOS ICMFAI ICMFAPC ICMFLSH ICMGET 
ICMOPEN ICMPUT ICMWEOP IFMEXEC ITIMA72H ITIMDC2S TIMRLE 

TIMRSE ITIMRUM TIMRUSM TIMTDEL OCMADD OCMBIM OCMBIM OCMCOL 
OCMCQM OCMCPY OCMCRM OCMDEF OCMDEL OCMDLB OCMDNL 

OCMDOL OCMEND OCMGEN OCMLCH OQCMLMG OCMLP OCMMUR 

OC MNP OCMOBJ OCMOFH OCMOMS OCMRCH OCMRED OCMREP OCMRMB 
OCMSAT OCMSOL OCMVEL OCMVLU OCMVOL PFMDC PFMTALL 

PUMBCAT PUMBCYC PUMBFIL PUMBFOQ PUMBLST PUMBPF PUMBSET 

PUMCOMN PUMCRAK PUMPURG PUMCRAK PUMIOQBF PUMLIST PUMMISC 

PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUMRPF 

PUMSTUB RHMLML RHMQAT RHMQOP RHMQRE RHMSFM USORT UTMDUR 
UTMPC1 UTMPC2 UTMPC3 UTMPC4 UTMPC5 UTMTSA UUSERI 


4.502 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 
Type 
Kane where nis the NVE control point number. 
KeSETLA (your _unsNVE) your_password 
KeGETF OS U=scat 
KeDS INSTALL GSL=NO GP=NQ AUzscat 
4o503 EXAMPLE OF NOS/VE “NORMAL” DEADSTART 
The Integration system has had the installation deadstart 
run on it. Also the files produced by the instailation 
deadstart have been made semi-private and are found on the 


catalog used in the NVExxxx call. 
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4.523 EXAMPLE OF NOS/VE “"NORMAL® DEADSTART 


Type (where DEV] is the same as the xxxx in the NVExxxx 
calf): 


Kane where n is the NVE control point number. 
KeSETLA (DEVI»sNVE) DEV1X 
KeGETF DS 


KeDS NORMAL 


4.5.4 EXAMPLE OF NOS/VE RECOVERY DEADSTART 


This is the kind of deadstart that should most frequently 
be done in a ™"ctosed shop" environment and consequentiy is the 
one for which ali =the parameter defaults are oriented. It 
presupposes that permanent file recovery has been successful. 


Type (where DEV1 Is the same as the xxxx in the NVExxxx 
cali): 


Kate where n is the NVE control point number. 
KeSETLA (DEV1»sNVE) DEVIX 

KaGETF DS 

K.DS 


445.5 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickly and do not 
need the product set or all validated users. 


Type 


Kane where n is the NVE control point number. 
KeSETLA (your_unsNVE) your password 

KeGETF DS U=scat 

KeDS NORMAL GSLENO GPEND QV=your_un AU=scat 


4.5.6 USE OF THE QUICK_DEADSTART COMMAND 


This command is intended as a development too! to 
facilitate "fast? deadstarts where recovery is not needed; 
Indeed» if this command is entered recovery.will not be 
pecformed when the system ifs brought down for whatever 
reasone Seecifying this command will cause an installation 
deadstart to take place. If the INITOD command is not 
specifled then a default value of *VSNO01" is used for the 
system deadstart device. Use of INITDO will allow setting the 
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deadstart devices identifier to any vatuee THIS COMMAND WILL 
NOT BE ACCEPTED FROM A DEADSTART COMMAND FILE. 

Format: QUICKDS ofr QUICK _DEADSTART 

Values: The default is false. Executing this command 
causes this initial value to be toggleds thus executing this 
command twice will cause the final value to be false. 

Note? QUICK_TEMPLATE_LOAD does not exist now. 


425 NOS/VE_INTERACTIVE FACILITY OPERATION 


42601 OPERATOR INITIATION 
To bring up the NOS/VE interactive facility do the 
Following: 
1) Bring up NOS/VE. 
2) Bring up NAM 
At the system console enter: 


3eNAMS2. for S82 
3.NAMS3., for $3 


3) If IAF is not up at control point ls enter: 


IAF. 
4.622 OPERATOR TERMINATIGN 
To terminate NOS/VE interactive any of the following may be 
done? 
— 3.CFO.DI»sAP=TAF. (3 is the NAM control point number) 


This is the preferred method. To bring NOS/VE interactive 
back ups you must first do a 3.CFDLENsAP=TAF. 


- 3.CFO.DI»aNE. (3 is the NAM control point number) 


This terminates the entire network including IAFsRBFs etc. 
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42603 OTHER GPERATOR CAPABILITIES 


To togicatty turn the printer ons under DSD enter: 


QON33. 
FORM3359TM. 


- To send a "shutdown warning” to all terminals togged on to 
TAF do: . 


3eCFO.IDs AP=TAF. {3 is the NAM control point number) 
- To send a message to all terminals do: 


3e.CFOMSGsALL»smessagee (3 is the NAM control point 
number ) 


- PASSON has the ability to record various types of 
diagnostic information. This capability is controlted via 
the sense switches at the PASSON contro! point. To turn a 
sense switch on (off) at control point N dos 


NeONSWX. (N.OFFSWX.) 


Where X¥ is the desired sense switch (1 to 6). The PASSON 
default is ali sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to ite. The sense switches currently used 
by PASSON are: 


Switch # use 
l Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfile 


4.7 NOSZVE_OPERATOR_ FACILITY _AND_ OPERATOR COMMANDS 


With the release of the Operator Facitity Phase 1 several 
changes to the NOS/VE Operating System will occur that will 
effect the users of the NOS/VE Operators Console. The 
Qperator Facifity runs as part of the NVE control point. When 
the request for K display appears on the NOS B Displays assign 
the K Display to the NVE control point. The Operator Facility 
is capable eof displaying both a feft and a right screen area 
at the same time. IF the operator wants both screens then 
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type in KK. The contents of these displays are determined by 
the commands entered by the operator. 


The left screen Is divided into four different areas. The 
top most area is the system header which contains the current 
date and times memory statistics» and an operator action 
message if one is posted. The cperator action will include 
the job sequence number of the owner of the message and 
‘message cancelled! if the message is cancetied because the 
task has terminated. The next tine contains the first 64 
characters of the operator action message (60 characters in 
stand alone). 


The next area of the screen is the main output area. This 
area has the fite name of GUTPUT. Any display command can 
have its output directed to this area as well as any system 
command. 


The third area is towards the bottom of the screen. This 
area is two tines tong and contains the response area. This 
will contain error messages from system commands. fhe area is 
cleared when the next operator typein is entered at the 
operator’ts console and received by NOS/VE. 


The fourth area is the prompt area. This will contain the 
status of the keyboard. If NOS/VE is processing a commands 
then the keyboard is locked and all typeins will be ignored. 
When the keyboard is lockeds the message ‘data received by 180 
- keyboard tocked' will appear at the screen's bottom. When 
the keyboard is untocked then any data in the keyboard buffer 
will be sent to NOS/VE. The bottom line is the last tine that 
was processed by Operator Facility. 


The right K Display has the file name OUTPUT RIGHT. There 
is onty one area on the right screen therefore the main 
display area is 10 fines tonger than the teft screen area. If 
a dayfile disptay or CP disptay is shown on the right screen 
you wif! get more tines: of information than on the left 
screene 


There are no default displays that come up automatically on 
either output display area. It is up to the operator to 
decide the display the operator wishes to see. The only parts 
of the display that come up automatically is the system header 
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display and the prompt area for keyboard status. 


The page width of the screen is 60 characters for 
standalone and 64 characters for dual state. The character 
set translation code is the same as that for the current NVE 
Subsystem contro! point. The escape code sequence for the 
special characters to be typed has not changed. There are a 
few differences in the processing of data by the Operator 
Facittity and NVE Subsystem. 


1) Do NOT end commands with a period. Periods are sent to 
NOS/VE. 


2) The NVE subsystem commands that begin with an asterisk will 
not be supported from the Dperator Facility control point. 
If these commands are entered from the OQperator facility 
they will be passed on to SCL where an illegal command will 
be issued. 


3) Routing of console job data to a specific job by the 
*'n=command! protoce! wiltt not be supported in dual state. 
This feature should work in standalone but will not be 
supported. 


4) No type ahead - commands cannot be entered until the prompt 
area shows that they are requested. 


There is one new conmand to replace the current display 
commands. The entry points for Zdiss Zdisbs and Sdis have 
been deleted, The new command is VEDISPLAY and has two 
parameters. The options are fisted hetlow. The values in 
paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*). This command wil! be 
processed by SCL and create a new system controft point task to 
display it's data. The user can have the same display type on 
each of the display areass if the user so desires. 


Command Name Display Type Screen Area 
Parameter Name Parameter Name 
DISPLAY OPTIONS OUTPUT (0) 


DISPLAY_ODPTION (00) 
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Parameter Values Parameter Values. 
VEDISPLAY (VED) DISPLAY _SYSTEM_LOG OUTPUT 
JOB_LLOG {JL) QUTPUT_LRIGHT (OR). 
CONTROL_LPOINT (CP) 
The default file name for all disptays is OUTPUT. 


The following Is a brief list of commands to bring up NOSVE 
with the Operator Facility installed. 


noNVEFFTF. to bring up NOS/VE. (See Section 5) 

Kye n = contro! point for NVE. 

KK» to bring up the K display on both screense 
KeVED JL to bring up the job log. 

or 


K.VED DISPLAY_DPTIONS=JL OQUTPUT=OUTPUT 
to bring up the job log using key word 
identifiers. 


KeVED CP OUTPUT _RIGHT | 
to bring up the control! point display on 
the right screen. 
or . 
KeVED DISPLAY_ODPTIONS=CONTROL_POINT OUTPUT=DUTPUT_RIGHT 
to bring up the control point display using 
key word 
identifiers. 


Ko XxX send any command to NOS/VE. 


Ke TERMINATE_SYSTEM_J0OB to terminate NOS/VE. 
Note: After the DS procedure has completed execution the 


command to enter to bring down the system is 
TERMINATE_SYSTEM_JOBs not TERMINATE_SYSTEM. 
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4.7.1 DELETE_LJOBLQUEUE !{ DELETE. JOBLQUEUVES § DELJQ (NEW) 


The purpose of this command is to delete all files from the 
Job input subcatalogs the print subcatalog or both. This 
command is only allowed from jobs with operator and or system 
priviteges. 


delete _job_queue Cauvueue_name=inputioutputiall] 
Ustatus=<status variable>] 


qgueue_name { qn: This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause ali files to be deleted from the 
job swap subcatalog and the job input subcatalog. 
Specifying OUTPUT will cause all files to be deleted 
from the job output subcataltog. Omission will cause 
ail to be used. 


status: See ERROR HANDLING. 
42722 REBUILD_INPUT_QUEUE { REBIQ (NEW) 


The purpose of this command Is to rebulid an entry in the 
Knewn Job List (KJL) from information in the System Label of 
the file representing the job being processed. This command 
is to be used during the process of recovering the input 
queues during recovery deadstart. 


rebuild input queue Cname=<name>d] 
Cstatus=<status varlable>] 


name { ni: This parameter specifies the file name of the 
file representing the job. An attempt is made to 
process the specified file within the catalog where 
job Input queues are known to reside. 


status: See ERROR HANDLING. 
4.7.3 REBUILD _OUTPUT_LQUEUE {¢{ REBOOQ (NEW) 


The purpose of this command is to rebuild an entry in the 
Known Output List (KOOL) from =information retained in the 
System Label of the file representing the output being 
processed. This command is to be used during the process of 
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EVE { REBOQ (NEW) 


recovering the output queues during a recovery deadstart. 


rebuiid_output_queue [name=<name>d] 
CTstatus=<status variabie>] 


name: This parameter specifies the file name of the file 
representing the output. 


process 


An attempt is made to 


the specified file within the catatog path 
of where job output aqueves are known to reside. 


status: See ERROR HANDLING. 


48 ROUTE _AN_INPUT_EILE_ FROM €170_T0_€180 


Through the system consoles enter: 


Type 


X¥.DIS. 
USERsAsB. 
GETsfilename. 
where filename identifies the Input file to be routed. 
ROUTEsfilenamesDC=LP»FC=RH. 


409 K_DISPLAY ASCII 


Support of 6-12 ASCII from the consote (K display) causes 


the following changes: 
INPUT IRANSLATED_10 INEUT 
4/1 /{ 
f2™ /) 
/3 # f+ 
74 % /- 
75 (reversed /) f= 
16 3 1* 
‘7 ? 4/ 
43 /» 
19 3} 4A to /Z 
JO . tCunderscore) 


TRANSLATEO.TO 


{ 
] 
> 
< 
§ {single quote) 
/ 

a 


- z (lower case) 
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4019 DSQL_ INFORMATION 


To create an Express Deadstart Dump (EDD) tape: 


1) 
2) 
3) 
4) 
5) 


6) 


7) 
8) 


9) 


Mount scratch tape {ring in) on a 9G-track drive. 
Push D/S button. 

Select U (Cutilities) display. 

Select — (EDD) display. 

Set channel (S$2=13). 

Set ECUU ($2=O0luu) 

E = equipment 


C = 1 for 47X drives 
2 for 66X drives 


uu = unit number of the tape drive to be used, 
Answer "dump number™ with a CR, 

Answer "non zero inhibits rewind” with a CR. 
Answer "channel controlware” with a CR. 


* = Warning if this step is omitteds DSDI canot 
process the dump tape. 


To create a tisting of the EDD tape: 


1) 
2) 


3) 


REQUESTsDUMP »NTsD=PEsF=SesLB=KU,sPO=R» VSN=your cholee<.. 
GETsDSDI/UN=DEV1. (On S/N 101.) 
or 
GET»sDSDI/UN=DEV1. (On S2.) 
Create DSDI directives file: 
A OSDI directive file should include the following: 


IOUMR. 
PROMR,. 


Cycie 5s July 1982 


Shed 


ee 


ma 


4=19 


NOS/VE Cycte 5 Helpful Hints 


07/07/82 


4.0 DUAL STATE DEADSTART AND OPERATION 
4.10 DSOT INFORMATION 


4) 


3) 


6) 


7) 


MEMMR. 

PRORF. 

Wa first byte_address»last_byte_adress»sasid. (where 
the first lbyte_address and last lbyte_address are hex 
byte addresses and asid is the asid of the segment to 
be dumped) 

Execute DSDI:3 


RFL»60000. 
DSDI»MsD»T="input directives fFile™. 


To run (after the first time): 

DSDIsT=n. 

(Does not read tape again.) 

To run interactively: 

Same as above, except to do W command must first do: 
DUTPUTsLISTFIL. 


C170 OSDI information can be found in Chapter 10 of 
the NGS SYSTEM MAINTENANCE Manual. 


A170 DSDI info can be found in document ARH3060 <= GID 
for A170 NOS/S2. 


4011 NOSZVE_TERMINATION 


o Bringing down dual state: 


Ken -—- n is the NVEFFFF control point 


Ke TERMINATE_SYSTEM_JOB 


o If not a normal termination 


Ken - n is the NVEFFFF control point 


Ke *RUN® 
Ke*ENDLST. 
Ke*ENDRUN. 
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4o12 A1lZ9_NOS_ SHUTDOWN 


Before teaving the machines it is necessary to bring NOS 
down. If NOS has crasheds a tevel 3 deadstart must be 
attempted even if the onty reason is to bring NOS down. To do 
alevel 3 deadstart: 

1) Push O/S button 

2) Select "0" display 
3) Select "PP" display 
4) Enter [=3 

5) Enter (CR) 

6) Enter date/time 

If a dump is desired but a crash has not occurred STEP. 
should always be entered before pushing the deadstart button. 
After the dump has been taken a tevel 3 deadstart should be 
performed. 

To bring NOS downs do the following: 

1) Enter: 
CHE 
The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 

2) Make sure no mass storage device has a checkpoint 
rquested. To do thiss enter: EsM. If the display shows 
there are no "C"™s in the status fields then all devices 
are checkpointed and you may continue. 


3) Enter: 
STEP +s 


4) Push deadstart button. 
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5.0 RECOVERY _OF _NOS/ZVE_PERMANENI_EILES 


Del QETVE FORMAT 


The general format of the SETVE command is 


XeSETVECPN=FFFFs UN=uns VSN=vsn»sD=d»sP=p,s B=bsC=csCH=ch) 


fFFF Is a string of no more than four characters. SETVE 


un 


appends ffff to 'NVE* to construct the name of a 
procedure file whichs when Invokeds willl deadstart 
NOS/VE. The default is TST. 


specifies the user number from which TPXXXK is 
attached. Un is the first cataiog searched for 


other files used in deadstarting and terminating. 


NOS/VE. The default is INT1l. 


specifies the deadstart command deck to be used when 
deadstarting NOS/VE. The function served by the 
deadstart command deck is analogous to the function 
served by the CMRDECK of NOS. Currently supported 
values for c and their respective uses are: 


Arden Hilts $3 S/N 02 open shop/hands-on time 
Arden Hilts $3 S/N 02 closed shop 

Arden Hifis $2 S/N 104 open shop/hands-on time 
10 Sunnyvale S2 closed shop installation 

0 Sunnyvate $2 closed shop continuation 


MO We 


The default is set in the file CMDS1. Currentty 
the default is 6. 


specifies an alternate catalog to be searched “for 
the various files used in deadstarting and 
terminating NOS/VE. The default is INT1. 


is used to Indicate that the system core command 
processor should accept commands from the console. 
Specifying D=T In the SETVE command aitows the 
operator to enter commands from the consotfe after 
processing the deadstart command deck. If the 
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eeerator wishes to Initialize the system device 
and/or install anew version of NOS/VE» D=T must be 
specified. The default is set In the file CMDS1,. 
Currentiy the default is D=F. 


p specifies the password for the catalog indicated by 
the un parameter. If this parameter is omitted the 
password will be generated by appending an *X*? to 
the UN parameter. 


ch specifies the octal channel to be used for NOS/VE 
disk I/0. The default is set in the fite CMBS1. 
Currentiy the default Is 2. 


ysn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
from the tape specifled. If it is omitteds then 
NOS/VE witlt be deadstarted from the permanent file 
TPXXXK. 


5e2 JSEIVE_USAGE 


Earlier versions of NOS/VE required that two SETVE commands 
be issued if the system was to he installed and subsequentty 
recovered. The current system does not require this. The 
oniy reason for issuing two SETVE commands is to provide a 
deadstart procedure that does not require/permit operator 
intervention. 


It should be noted that once the SETVE command has been 
issued» it need not be issued again unlesseess 


1) There is a need to change one or more of the parameters 
specified in SETVE. 


2) The command files NVEFFFs generated by the SETVE 
command is purged from the system. 


Two examptes of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first example shows a “hands on™ user 
working with recover ye The second illustrates these concepts 
for atypical NOS/VE closed shop. This writer hopes that the 
reader will find both examples useful and illuminating. 

Ie A “hands on™ user 

The command file NVERSD is bullt and instafted in NOS 
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by typing 
MeSETVE(RSDsUN=RSDaVSN=TAPEs B=DEV1sC =62D=T) 


Several of the choices of parameters are worth 
noting. 


1) By specifying the VSN parameter the user has built 
a command file that will deadstart the system 
directly from the tape produced by NVESYS. 


2) The user in this exampfte has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NOS/VE disk I/0 channel {ch parameter) to default 
to 22 ne conciudes that the user is running on 
the Arden Hills S2. 


3) The user has specified O=T. This is important. 
The deadstart command which triggers installation 
of a recoverable system cannot be read from a 
deadstart command deck. It must be entered from 
the console at deadstart time. Specifying D=T 
allows the operator to enter commands from the 
console, 


NOS/VE is deadstarted by typing 
neNVERSD. 


at the console. (nis a control point which is NOT ls 2 
or ordinartity occupied by MAGNETs BATCHIDs or SYSTEM) 


The user brings up the K display by typing 
KaMe 
(where n is the NVE control point.) 

Presently» the deadstart command deck is displayed 
and the user is prompted for input. The deadstart 
command deck used in this exampie ltooks tike this: 

VUSECP S$2CFIG 
USETIP EMPTY 
SETOCT $7155 _1 
SETDD $885_12 32 


The user types 
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Il. 


KeINITDD VSNOO1. 
K.»GD. 


The system accepts the commands and instalis and 
deadstarts NOS/VE. 


After the system comes downs via either controtled 
termination or a crashs the system can be recovered (Cif 
necessary) and redeadstarted by typing 
neNVERSD. {where nis an appropriate contro! point.) 


When the deadstart command deck is displayeds the 
user types . 


GO. 


This will cause NOS/VE to be deadstarted without 
initializing the system device. 


A typical “closed shop" 


Two command fiiless NVECLSH and NVEINSTs are created 
by typing 


XeSETVE(CLSHsUN=CLSHs B=DEV1sC=40sCH#1) 
XoSETVECINSTsUN=CL SH» B=DEV1sC2109CH=15D=T) 


One notes that 


1) Closed shop is deadstarted from a TPXXXK file in 
the CLSH catalog. 


2) Specifying D=T» for NVEINSTs causes deadstart to 
pause for operator intervention. 


3) Using DCF deck 40 for continuation suppresses 
redundant (and possibty damaging) reexecution of 
the configuration protog. 

A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure. The operators in this examples, types 
NeNVECLSH. 


NOS/VE wil! recover (if necessary) and deadstart. No 
operator intervention is required. 


Cycite 59 July 1982 


we 


ee ae 


we Be oe 


5-5 
NOS/VE Cycle 5 Helpful Hints 
5.20 RECOVERY GF NGOS/VE PERMANENT FILES 
5.2 SETVE USAGE 


If it is necessary to reinitialize the system devices 
or if the installation is upgrading to a new version. of 
NOS/VEs the operator keys 


NoNVEINST. 


This causes deadstart to pause and wait for operator 
input when deadstart commands are being processed. 
There are two cases requiring discussion here, The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used onity when it 
is necessary to reinitialize the system device. 


The first case involves the instaltation of a new 
version of NOS/VE. In order to instali a new version of 
the systems the old system must have been idied in an 
orderly way. A new system cannot be installed ifs 
following a crash»s the system being superceded was not 
recoyered., Assuming everything in the ofd system iis 
tidys and the file systems are compatibles the operator 
keys 


KezUSECP EMPTY. 

KeSETSA INSTALL _JOB_LTEMPLATES 1. 

KeGO. 

when the system displays the deadstart command deck and 
prompts for input. The new system is installeds the 
file system is preserveds and deadstart proceedse 


The second case amounts to an installation 
deadstart. This should be used onty with full knowledge 
that any files which may have existed on mass storage 
one to this deadstarts willbe blasted. into. oblivion 
by_it. 


An Installation deadstart will be required if 


1) This is the initiat installation of a recoverable 
version of NOS/VE. 


2) If the file systems of the system being installed 
and the system being superceded are not 
compatiblfe. 


3) If the file system has been damaged beyond the 
possibit ity of recovery. 


An installation deadstart is effected by typing 
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KeINITOD VSNOO1. 


KeGO. 


when 


the deadstart. command deck is displayed and the 


operator is prompted for input. 


NOTES: 


ls 


20 


The CMDS1 file used to deadstart NOS/VE must have 
the DEBUG2 flag set to TRUE. When NOS/VE is 
deadstarted» the catatog specified by the UN 
parameter is first in the search order for CMDS1l1> 
Followed by the catalog specified by the B 
parameter. 


See Section 3.3 
Notebook for other 
file. 


of the Integration Procedures 
information about the CMDS1 


If NOS/VE crashes and a dump is desired (in the 
context of our second example) 

i. Type du at the 
"WRITING 
immediately. 
COMPLETE* 
later. 


MDD 

IMAGE 
The 

should 


The 
should 
"IMAGE 

few 


console. 
FILE* 

message 
appear a 


message 
appear 
FILE 
moments 


Push the deadstart button. 
Take the EDD dump. 
Do a level 3 NOS deadstart. 

Alternatively the operator can skip step i if 
she/he is sure to redeadstart NOS/VE after step 
ive In this event the system will detect that the 


image file was never createds will create ones and 
will recover from it. 
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6.0 SYSTEM CORE DEBUGGER 


The System Core debugger provides a set of capabilities 
intended to assist in debugging the operating system. 
Services provided by the debugger are task oriented: seiection 
of the tasks to be debugged must be made via debugger 
subcommands,. No tasks will be under contro! of the debugger 
unless they are selected. The selection capability allows any 
number of tasks to be debugged simuitaneously; from one task 
to all tasks In the system. Obviously a capability this 
powerful must be used with some cares The System Core 
debugger uses the debug hardware to provide these 
capabilities. 


6.1 RYSDEBUG 


The purpose of this command is to initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command file or as a command in any job. 
sysdebug 


This command has no parameters; alt information the 
debugger requires is provided via subcommands,. 


The system core debugger can also be invoked from the MOD 
console. The format of the command jis? 


DO nesysdebug 

where nis the job ordinal of the desired job. The debugger 
Is brought up in the job monitor task of the job. Ali system 
core debugger subcommands are availablies but must be prefixed 
by the MDD command DQ, 

The system core debugger can also be brought up (from the 
MDD console) by specifying a global task id. The format of 
the command is? 

DO netdebug ggggg9 
The vatue of n tis ignoreds and the vatue gaqgggqgg specifies the 
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NOS/VE giebal task id (32 hex bytes) of the task to bring the 
debuager up ine If the task id is invalids, then the command 
will be ignored. 


6.2 SUBCOMMAND PARAMETER DEFINITIONS 


<name> 3:32 1-8 character breakpoint name 
<condition>d 23= READIWRITETRNIS BRANCHICALLIDIVFLTSARLOS$ 
AROVFLIEXOVFELIEXUNFLEFPLOSSFPINDEFS INVBDP 


<base> 23:= process virtual address 
<offset> 3:=2= integer 

<ltenath>d ::= integer 

<frame> 22:= 1..106 

<count> 22= 14210000 

<regid> s:= XIAP 

<regno> %2= 0221530..0F(16) 
<value> i:= integer 

<time>d 33s 


120(2**31)-1 
<ystring> 33:2 'charstring? 
<datatype>d %t2= HEXTASCIISASC I DEC 
<change_count> %:3= 1.428 
Cselector> 33= FULLIAUTOISAVE 


663 IYSTEM_CORE DEBUGGER SUBCOMMANDS 


Within the descriptions which follows optional parameters 
are enctosed in brackets. Default values § for optional 
parameters are also defined. 


60301 SELECT 


The purpose of this subcommand Is to select the tasks In 
which the system core debugger is to be active, When the 
debugger is first calleds It is not active in any task. To 
use the debugger therefores it is necessary to select the 
tasks In which it is to beactive. 


select <selection option> [(€<ring number> } <active job tist 
ordinal>] 


selection_option: This parameter specifies one of a 
series of selection options used to control the 
tasks In which the debugger will be active and some 
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other debug options. The selections are remain In 
effect until they are explicitiy changed with 
subsequent SELECT subcommands. Valid selection 
options are: 


Crightileft> —- This selects the screen for the debug 
display. The display stays active when the screen 
is switched. 


<jobmonitorinojobmonitor> <- This selects whether or 
not to debug job monitor tasks. 


<userinouser> - This selects whether cr not to debug 
user tasks {(4.e. those that are not job 
monitors). 


<highring> - This specifies the highest ring in 
which debug traps will be recognized. Traps 
occurring in rings above this selection will be 
ignored. 


<jobinojob> - This enables or disables debugging for 
the job at the specified active job tist 
ordinal. The system job has an active job list 
ordinal of zero. 


<alljobsinojobs> - This activates or deactivates 
debugging in all jobs. 


The initial selections are: RIGHT» NOSTEP» 
NOJOBMONITORs NOUSER»s HIGHRING=3» NOJOBS. 


62342 BREAKPOINT 3 8B 


The purpose of this subcommand is to sefects a program 
interrupt which is to occ specified condition within a 
specified virtual address range. 


breakpoint <name> <condition> [<base>] [<offset>] (€<length>] 

The <name> Is any user supplied name “for identifying the 
breakpoint. A maximum of thirty two breakpoints can be 
selected. When a trap occurss the <name>d of the breakpoint 
which caused the trap is displayed. 


The base parameter is required when specifying a new 
breakpoint name; offset and tength specifications are optional 
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in this case. When adding a new condition selection to an 
existing breakpoints bases offsets and length parameters may 
not be specified. 


Bases offsets and iength parameters define the desired 

virtual address range: <hase> + <offset> yields a 

first-byte~address; first-—byte-address + <length> -1 yields a 
last byte address. 


Default parameter values: 
<offset>? G 
<lengthd: 1 

62.323 REMOVE_BREAKPDINT ¢ RB 

The purpose of this subcommand is to deselect a previously 
selected program inte 
remove breakpoint <name> {<condition>] 

If oniy the name parameter is specifieds all conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specifieds onty that condition is deselected; however, if the 


specified condition is the onty condition selecteds all 
evidence of the named breakpoint is removed. 


6030% LIST_BREAKPOINT $ LB 

The purpose of this subcommand is to provide a tist of 
currently selected breakp and associated conditions. 
list.-breakpoint (<named] 

If the name parameter ts specifieds information is 
displayed for the named breakpoint only. If the name 


parameter is not specifieds information is displayed for ail 
currently defined breakpoints. 
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60325 CHANGE_BREAKPDOINT ¢: CB 


The purpose of this subcommand {Is to change the virtual 
address range of a previ specified breakpoint. 


change breakpoint <name> <base> [E<offset>] C<length>d} 


Bases offsets and tength parameters define the desired 
virtual address range: <base> + <offset> yields a 
first-byte-address; first-byte-address + <length> -1 ylelds a 
Jast byte address. 


Default parameter values: 


<ofFset>: 0 
<length>: 1 


60326 TRACE BACK : TB 


The purpose of this subcommand is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedures. Validation of PVA's 
is now performed. 


Information displayed for each selected stack frame 
consists of: 


~- Stack frame number 3 

- Current P-address of the associated procedure; 

- Virtual address of the start of the stack frame; 
~ Virtual address of the stack frame save area. 


trace_back (€<frame>1] (<count>] CFULLE SHORT) 


The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. Stack frame 
number one is associated with the interrupted procedures stack 
frame two is associated with the interrupted procedure's 
predecessors etce 


The module name provided on the traceback is usually 
correct but not quaranteed. 


The count parameter specifies the total number of stack 
frames for which information is to be displayed. 
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Default parameter values: 
<frame>: 1 
€count>: 1 

6e3e7 DISPLAY STACK_FRAME : DSF 

The purpose of this subcommand is to dispiay selected 
information from a specifi stack frame. 
display stack frame (<frame>] (<setector>] 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 
one is associated with the interrupted procedure, stack frame 
two is associated with the interrupted procedurets 


predecessors etc.) 


The selector parameter identifies a region of the specified 
stack frame: 


AUTO: Causes the automatic region of the stack Frame to be 
displayed. 


SAVE: Causes the save area of the stack frame to be 
displayed. 


FULL: Causes both the automatic and save areas of the stack 
frame to be displayed. 


Default parameter values: 

<frame>: 1 

Cselector>: FULL 
60328 DISPLAY _REGISTER ¢ DOR 

The purpose of this subcommand is to disptay the contents 

of a specified registe interrupted procedure. 
display register <regid> {<regno>] (<datatype>d) 
Default parameter values: 

€regno>: 9 
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€<€datatype>: HEX 


62329 DISPLAY_MEMORY : DM 


The purpose of this subcommand is to display the contents 
of a specified area of virtual memory. Validation of PVA's is 
now oerformed. 
display _memory <base> [<length>] 

Defauit parameter values; 


<length>: 8 


623210 CHANGE_MEMORY 3: CM 


The purpose of this subcommand is to set a specified vatue 
into a specified loca of virtual memory for a specified number 
of bytes. Validation of PVA's is now performed. 
change memory <base> <value> <change_count> 
Default parameter values? 


€<change_count>: 1 
6e3e211 RUN 
The purpose of this subcommand is to invoke program 


execution after a selected p interrupt has occurred, 


run 


6e3e12 SUPER_CHANGE_ MEMORY ¢ SCM 


The purpose of this subcommand is the same as the change 
memory subcommands that Is» to change the contents of virtual 
memor ye It differs from change memorys howevers in that it 
will change the attributes of the segment to aliow memory to 
be writtens and then change the attributes back to their 
original values. 
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The command format Is the same as the change memory 
subcommand,. 


623213 FORMAT i FMT 


The purpose of this subcommand is to set the system core 
debugger into a mode where all subcommand output is sent to a 
permanent file, This is done by having the task running the 


debugger communicate with another task running in the systen. 


job. It is this other task that actually creates and writes 
the permanent file. The entry point of this task is 
OSP$BROKEN_ JOB_LDUMP_TASK. It will normally be initiated by 
the 0S procedure. If it is not runnings a diagnostic will be 
issued. This task will create successive cycles of the 
permanent file '"DUMP® In the SYSTEM catalog. These files 
contain ASCII text data written In BAM variable records. The 
parameter to this command is a string which will be output as 
the First line of the file. 


format string 


623214 UNFORMAT 7? UNFMT 


The purpose of this subcommand is to leave the output mode 
established by the FORMAT command. CGutput will again be sent 
to the operator console. At this point the permanent File 
will be flushed to mass storage. 


unformat 


63215 DISPLAY_MONITOR_FAULT + DISMF 


The purpose of this subcommand is to display any monitor 
faults present in this task. See the section titted "NOS/VE 
Processing of Job Mode Software Errors! for more information. 


Ali monitor fault buffers are displayed in the hope they 
will show some task history. If a given fault buffer is 
invalid the message “following fault is not present™" Is 
displayed. 


display _monitor fault 
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603216 DISPLAY_XCB ¢ DISXCB 


The purpose of this subcommand is to display ali of the 
fields of the current task's (i.ees the task running the 
debugger) execution control block. 


623017 DISPLAY_TASK_ENVIRGNMENT ¢ DISTE 


The purpose of this subcommand is to display the XCB of ati 
tasks running within the current job (f.ee.s the job with the 
task running the debugger). If the command is entered white 
the debugger is in format modes then a full XCB Is displayed» 
otherwise just the task names XCB address and giobal task id 
are displayed. 
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F PROCESSING OF JO8 MODE SOFTWARE ERRORS 


7.0 NOS/VE_PROCESSING QE_JO0B_ MODE SOFTWARE ERRORS 


7.1 INTRODUCTION 


whi 
The 
by 
to 
att 


Tasks running in job mode will occasionally cause an error 
ch is detected either by the hardware or NOS/VE monitor. 

action taken when an error tike this occurs Is controlled 
various system attributes. The purpose of this section is 
discuss the types of errors and the effect a given system 
ribute will have upon the handling of the error. 


7.2 TYPES_QF_ERRORS 


1) 


2) 


BROKEN TASK: A broken task Is a task tn which the trap 
mechanism is not able to function correctly. NOS/VE 
monitor will attempt to repair the trap mechanism and send 
a broken task fault to the task. The specific cases of a 
broken task are: 


system error job mode software has 
deciared the task to be 
broken. (This is a special 
case of broken task.) 


monitor fault buffer full Job mode errors are 
occuring but are not being 
processed by job mode. 


traps disabled a job mode error has 
occurred while traps were 
disabled. 

invalid Ae the task's AO register was 


invalid. 


UCR/MCR traps disabled UCR/MCR error occurred with 
traps disabled. 


MCR FAULT: This error signifies that job mode caused a 
hardware detected MCR fault. This may be caused by 
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software or hardware detected uncorrectable error. 


3) UNKNOWN SYSTEM REQUEST: This error signifies that job mode 
issued a monitor request that is either invalid or cannot 
be issued from the ring it was Issued from. 


4) SEGMENT ACCESS FAULTS: These errors signify that job mode 
encountered or caused one of the following errors: 


—-~ page fault for an address greater than EOI on a 
read-only file (segment) 


—- disk read error 


These errors either originate In NOS/VE monitor or cause 
the hardware to exchange to monitor. Depending on the values 
of certain system attributes» monitor will halt or reflect the 
error back to job mode as a monitor default. 


It is at this point that the system core debugger can be 
activated. (See the definition of SYSTEM_DEBUG_RING in the 
next section.) 


The normal job mode OS actions for these fauits are: 


broken task exit 
MCR fault cause condition 
invalid system request exit 
segment access cause condition 


7o3 SYSTEM_ATIRIBUIES_EDR_ERROR_ PROCESSING 


The following system attributes can be set or displayed by 
the SETSA and DISSA commands. 


7e3e1 HALTRING 


If a broken task or MCR fault occurs at or below the value 
of HALTRING (P register ring number)s NOS/VE monitor will halt 
the system. S8roken tasks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode. 
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7e30e2 SYSTEMLERROR_HANG_COUNT 


This is the number of broken task errors allowed to occur 
in any given task before that task is considered a hung tasks 


72303 HALTLON_HUNG TASK 


If this attribute is trues then an occurence of a hung task 
will cause NOS/VE monitor to hatt the system. If the 
attribute is false» the task will be sent a signal to thangt 
itselfs ise. to go into an infinite wait doing nothing. Jobs 
with hung tasks will have a *H in the status fieid on the 
operator CP display. 


A hung task will aiso occur if any error happens in job 
mode ring 1. 


70304 SYSTEM_DEBUG_LRING 


If an error {broken tasks» MCR faults unknown system 
request» or segment access fauit) occurs at or below the vatiue 
of this attribute (P register ring number)s the system core 
debugger will he Invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commands. . 


If the RUN command is issued to the debugger», the system 
will take its normal action for the specific fault. 


70325 DUMP_LWHEN_DEBUG 


When the system core debugger is invoked by a fault at or 
below SYSTEM_DEBUG_RING and the DUMP_LWHEN_DEBUG attribute is 
trues the debugger will automatically create a dump of the 
task (see system core debugger command FORMAT). When the dump 
is completes, normal fault action will take place. The 
following system core debugger commands are executed during an 
automatic dump: 


FORMAT automatic dump data 
TB 1 1000 
DISMF 
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DISXCB 

DM 00300000000 10000(16) 
DM 00400000000 10000(16) 
DM 00500000000 10000(156) 
DM 00600000000 10000(16) 
DM OOFO0000000 10000116) 
DM 01000000000 10000(16) 
DM 01100000000 10000(16) 
DISTE 

UN FORMAT 
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8.9 STAND ALONE DEADSTART 


8.0 STANDALONE DEADSTART 


Standalone deadstart does not work for Cycte 3. Code will 
be transmitted for Cycte 4 to repair this; this section wilt 
be rewritten then. 
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9.0 INTERACTIVE PROJECT DUMP ANALYSTS PROCEDURES 


9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 


The foltowing procedures were developed by the interactive 
project to assist them In interpreting dumps. They gquarantee 
the procedures work if your user name Is IFP3 otherwise caveat 
emptor.e For more information about these proceduress contact 
Fred Bischke. 


The following dump analysis procedures are availiabie in the 
IFP catalog: 


9.1 
EDDSIM 
This is a CCL procedure which brings an EDD dump tape on a 


specified 


VSN into the simulator. The procedure can be accessed from 
the IFP 


catalog as follows: 
getseddsim/un=ifp 
beginsseddsimsvsn ( vsn is the vsn of the EDD dump tape ) 
922 
ANALEXC 
This is a Simulator INCLUDE file which does a preliminary 
analysis of 
the current simulator exchange package { when the system 


crashes in task 
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9.0 INTERACTIVE PROJECT DUMP ANALYSTS PROCEDURES 
922 


servicess this will normally be JPS ). A ar exc=mon or ar 
exc=rma can be 


used to get into another exchange package before doing the 
include. 


The include file is ANALEXC/UN=IFP. It can be called from 
the simulator 


as follows: 
'getsanalexc/unzifp!' 3; Include anatlexc 


{carriage return) a tfone carriage return must be entered 
after an INCLUDE 
in order to start it up 


923 


SEGDUMP 


This is a CCL procedure which calls DSDIV to dump a 
specified segment to 
a list file which can then be examined with an editor or 
printed. 
The procedure can be accessed from within the Simulator as 
follows: 
'getssegdump/un=Iifp!' 3 theginsasssegdumpssegslensfilesexcscpf! <* 


The segdump parameters are: 
seg ~ segment number in hex ( default is 1 ) 
fength — number of bytes to dump in hex ( defauit is 16000 ) 
list ~ name of the fist file ( default is LIST ) 
exc - reference exchange package ( default is JPS ) 
cpf - name of checkpoint file ( default Is CPF ) 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
9.3 


In most cases of task services debugging», only the seg 
parameter is 


needed, 
944 
ANALJOB 


This is a CCL procedure which uses DSDIVs xXEDIT and the 
Simulator to 


perform an analysis of all tasks in a specified job. The 
procedure can 


be accessed from within the simulator as follows: 
'getsanal job/un=ifp' 3; theginssanal jJobssegscpf? 


The analjob parameters are: 
seg —~- the monitor segment which contains the exchange 
packages of the job { 14 Is the system jobs 15 is job 1 etc. 
) ( default is 14 } 


cpf ~- the name of the simulator file ( default is CPF ) 
After the procedure has completeds a tist of the RMAs of 
the . 
job's exchange packages can be obtained by doing the 
following: 
include tplist 


{carriage return) 


A traceback of all tasks in the job can be obtained by 
doing the 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
9.4 


PPE er rrr rer rrr rT Try rrrrerrrrrererrrrliTIL TLL LLL 
following: 
include tbtist 
(carriage return) 


include tbrun 


(carriage return) 
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10.0 ARDEN HILLS DEVELOPMENT _LAB_ SUPPORT BY_INTEGRATION 


what we have established in the lab so far is the following: 


A 600 tape capacity tape rack for general usee If your 
project would ltike to reserve a section of this tape racks 
contact Tim McGibbon or Bonnie Swierzbin 


A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to 
date. (If you have been using this cabinet for 
unauthorized storage - beware. We have the key to the 
lock!) More will be published about the contents of this 
cabinet Jaters and a cabinet index will be posted in the 
jab to help tocate where things are supposed to be placed 
within the cabinet. This cabinet is currently tocated in 
the southeast corner of the labs is 6 fte 8 ine tall, 
gray in color and with stiding door. 


A microfiche reader and a metal box containing the most 
recent microfiche of the system compilation ftistings and a 
link map. These items are kept on the table to the right 
of the console. 


A desk documentation rack for reference manuals and Tom 
McGee's collection of "how to™ goodies. The objective is 
to have this reference information at arm's tength of the 
consoles but it is currently on top of the two-level unit 
by the West wall. 


At or near the console is a small notebook containing the 
NOS System Programmer's Instant» NOS Application 
Programmer's Instants and the 180 Instruction codes. 


Feel free to examine and use all of the above materials while 
in the tab. 


Do not remove or abuse any of these materials, 


Piease notify Tim McGibbon or Bonnie Swierzbin of any 
probiems or deficiencies of these materiais. teave a note if 
we are not avallable,. 
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1.0 Hardware Overview 


1.1 
1.2 


1.3 


An introduction to CYBER 1806 
C18e Instant 


Model Independent General Design Specification - 
ARH1700 


220 NOS Reference Manuals 


2el 
202 


223 


XEDIT V3.0 ~- 60455730 
IAF V1.0 User's Guide - 60455260 


NCS Reference Manual - Vol 1s 60435400 —- Vol 2» 
60445300 


NOS Instant 

NOS Operators Guide - 60435600 
NOS Diagnostic Handbook 

NOS A170 ERS 


NOS A170 GID — ARH3060 


3.0 NOS/VE Reference Pocuments 


301 


302 


Program Interface ERS - <ARH36510 - obtained from 
Karen Rubey (482-3966) or via SESe»TOOLDOC 


Command Interface ERS —- <ARH3609 - obtained from 
Karen Rubey (482-3966) or via SES-TOOLDOC 


NOS/VE Procedures and Conventions - SESD010 - 
obtained by SES.TOBGLDOC 


Listing of all NOS/VE Modules - obtained by 
SESsDEVI»~LISTNVE. See Integration Procedures 
Notebook for details. 


NOS/VE Internal Interface Maintenance Procedures 
Memo available from S.C. Wood. 


Integration Procedures Notebook Obtained by: 
Acquires IPNDOC/UN=DEV1. SESePRINTsIPNDOC. 
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4.1 
4.2 
403 
424 
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4.6 


07/07/82 
Reference Documents 
CYBIL Interactive Debugger ~— ARH3142 
SES User's Guide - ARH1833 
CYBIL Specification — ARH2298 
C180 Assembler ERS — ARH1693 
Simulator ERS — ARH1729 
VEGEN ERS — ARH2591 
VELINK ERS ~— ARH2816 
Simulated I/0 ERS - ARH3125 
Object Code Utilities ERS - ARH2922 
CYBIL Implementation Dependent Handbook -— ARH3078 


CYBER 180 INTERACTIVE DEBUG External Reference 
Specification and Users Guide - $4028 


CYBER 180 II Assembler ERS - ARH3945 


ERS for Source Code Utility -—- ARH3883 
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